github

Execute GitHub operations (PRs, issues, milestones, labels, comments, merges) using Python scripts with structured output and error handling. Use when working with pull requests, issues, review comments, CI checks, or milestones instead of raw gh. Use when you say "create a PR", "add label to issue", or "check CI status". Do NOT use to read a pasted github.com URL (use github-url-intercept).

Zur Installation springen

Repository: rjmurillo/ai-agents
Letzte Quellaktivität: 8. August 2026 um 10:12
Erkannte Sprache von SKILL.md: Englisch
Sterne: 41
Forks: 13

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/rjmurillo/ai-agents --skill github

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Datei-Explorer

73 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

spec

Define what to build. Transform a problem into testable requirements with acceptance criteria.

2026-08-09

session-end

Validate and complete session logs before commit. Auto-populates session end evidence (commit SHA, lint results, memory updates) and runs validation. Use when finishing a session, before committing, or when session validation fails. Do NOT use to create a new session log (use session-init) or to repair a session protocol failure reported by CI (use session-log-fixer).

2026-08-09

session-init

Create protocol-compliant JSON session logs with verification-based enforcement. Autonomous operation with auto-incremented session numbers and objective derivation from git state. Use when starting any new session. Use when you say "start a session", "create the session log". Do NOT use for mid-session protocol checks (use session), or to complete and validate a log at the end of a session (use session-end).

2026-08-09

Alle aus diesem Repository ansehen

name	github
version	4.0.0
description	Execute GitHub operations (PRs, issues, milestones, labels, comments, merges) using Python scripts with structured output and error handling. Use when working with pull requests, issues, review comments, CI checks, or milestones instead of raw gh. Use when you say "create a PR", "add label to issue", or "check CI status". Do NOT use to read a pasted github.com URL (use github-url-intercept).
license	MIT
metadata	{"domains":["github","pr","issue","labels","milestones","comments","reactions"],"type":"integration","complexity":"intermediate","generator":{"keep_headings":["Decision Tree","Offline Invocation","Script Reference","Output Format","See Also"]}}

GitHub Skill

Use these scripts instead of raw gh commands for consistent error handling and structured output.

Triggers

Phrase	Operation
`create a PR`	new_pr.py
`respond to review comments`	post_pr_comment_reply.py
`check CI status`

Need GitHub data?
├─ List PRs (filtered) → get_pull_requests.py
├─ PR info/diff → get_pr_context.py
├─ CI check status → get_pr_checks.py
├─ CI failure logs → get_pr_check_logs.py
├─ Review comments → get_pr_review_comments.py
├─ Review threads → get_pr_review_threads.py
├─ Unique reviewers → get_pr_reviewers.py
├─ Unaddressed bot comments → get_unaddressed_comments.py
├─ PR merged check → test_pr_merged.py
├─ Copilot follow-up PRs → detect_copilot_followup_pr.py
├─ Validate PR description → validate_pr_description.py
├─ Issue info → get_issue_context.py
├─ Merge readiness check → test_pr_merge_ready.py
├─ Latest milestone → get_latest_semantic_milestone.py
├─ Actionable backlog → get_actionable_items.py
└─ Need to take action?
   ├─ Create issue → new_issue.py
   ├─ Create PR → new_pr.py
   ├─ Reply to review → post_pr_comment_reply.py
   ├─ Reply to thread (GraphQL) → add_pr_review_thread_reply.py
   ├─ Comment on issue → post_issue_comment.py
   ├─ Add reaction → add_comment_reaction.py
   ├─ Apply labels → set_issue_labels.py
   ├─ Set issue milestone → set_issue_milestone.py
   ├─ Set PR/issue milestone (auto-detect) → set_item_milestone.py
   ├─ Assign issue → set_issue_assignee.py
   ├─ Resolve threads → resolve_pr_review_thread.py
   ├─ Unresolve threads → unresolve_pr_review_thread.py
   ├─ Process AI triage → invoke_pr_comment_processing.py
   ├─ Assign Copilot → invoke_copilot_assignment.py
   ├─ Enable/disable auto-merge → set_pr_auto_merge.py
   ├─ Close PR → close_pr.py
   └─ Merge PR → merge_pr.py

# No PyPI round trip. Runs read-only PR status offline.
# CLAUDE_PLUGIN_ROOT is set in a vendored install; falls back to .claude in-repo.
SCRIPTS_DIR="${COPILOT_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.claude}}/skills/github/scripts/pr"
python3 "$SCRIPTS_DIR/get_pull_requests.py" --state open
python3 "$SCRIPTS_DIR/get_pr_context.py" --pr <N>
python3 "$SCRIPTS_DIR/get_pr_checks.py" --pr <N>

Script	Purpose	Key Parameters
`get_pull_requests.py`	List PRs with filters	`--state`, `--label`, `--author`, `--base`, `--head`, `--search`, `--limit`
`get_pr_context.py`	PR metadata, diff, files	`--pull-request`, `--include-changed-files`, `--include-diff`
`get_pr_checks.py`	CI check status, polling	`--pull-request`, `--wait`, `--timeout-seconds`, `--required-only`, `--output-format {json,human,auto}`
`get_pr_check_logs.py`	Fetch logs from failing CI checks	`--pull-request`, `--max-lines`, `--context-lines`
`get_pr_review_comments.py`	Paginated review comments with stale detection	`--pull-request`, `--include-issue-comments`, `--detect-stale`, `--exclude-stale`, `--only-stale`
`get_pr_review_threads.py`	Thread-level review data	`--pull-request`, `--unresolved-only`
`get_pr_reviewers.py`	Enumerate unique reviewers	`--pull-request`, `--exclude-bots`
`get_unaddressed_comments.py`	Bot comments needing attention	`--pull-request`
`get_unresolved_review_threads.py`	Unresolved thread IDs	`--pull-request`
`wait_for_unresolved_zero.py`	Settling gate: poll until unresolved count holds at zero across bot scans	`--pull-request`, `--interval-seconds`, `--max-wait-seconds`, `--strict-pagination`
`test_pr_merged.py`	Check if PR is merged	`--pull-request`
`detect_copilot_followup_pr.py`	Detect Copilot follow-up PRs	`--pr-number`, `--owner`, `--repo`
`post_pr_comment_reply.py`	Thread-preserving replies	`--pull-request`, `--comment-id`, `--body`
`add_pr_review_thread_reply.py`	Reply to thread by ID (GraphQL)	`--pull-request`, `--thread-id`, `--body`, `--resolve`
`resolve_pr_review_thread.py`	Mark threads resolved	`--thread-id --expected-pull-request` or `--pull-request --all`
`unresolve_pr_review_thread.py`	Mark threads unresolved	`--thread-id` or `--pull-request --all`
`get_thread_by_id.py`	Get single thread by ID	`--thread-id`
`get_thread_conversation_history.py`	Full thread comment history	`--thread-id`, `--include-minimized`
`test_pr_merge_ready.py`	Check merge readiness	`--pull-request`, `--ignore-ci`, `--ignore-threads`
`set_pr_auto_merge.py`	Enable/disable auto-merge	`--pull-request`, `--enable`/`--disable`, `--merge-method`
`invoke_pr_comment_processing.py`	Process AI triage output	`--pr-number`, `--verdict`, `--findings-json`
`new_pr.py`	Create PR with validation	`--title`, `--body`, `--base`
`validate_pr_description.py`	Validate PR description	`--title`, `--body`, `--body-file`, `--fail-on-violation`
`close_pr.py`	Close PR with comment	`--pull-request`, `--comment`
`merge_pr.py`	Merge with strategy	`--pull-request`, `--strategy`, `--delete-branch`, `--auto`

Script	Purpose	Key Parameters
`get_issue_context.py`	Issue metadata (no comments)	`--issue`
`get_issue_comments.py`	Issue comment thread (discourse)	`--issue`, `--limit`
`new_issue.py`	Create new issue	`--title`, `--body`, `--labels`
`close_issue.py`	Close with optional comment (`--verify-claims` aborts when a cited commit/PR does not resolve on the remote)	`--issue`, `--reason`, `--comment`, `--verify-claims`
`reopen_issue.py`	Reopen with optional comment	`--issue`, `--comment`
`set_issue_labels.py`	Apply labels (auto-create)	`--issue`, `--labels`, `--priority`
`set_issue_milestone.py`	Assign milestone	`--issue`, `--milestone`
`post_issue_comment.py`	Comments with idempotency	`--issue`, `--body`, `--marker`
`invoke_copilot_assignment.py`	Synthesize context for Copilot	`--issue-number`, `--what-if`
`set_issue_assignee.py`	Assign users to issues	`--issue`, `--assignees`

Script	Purpose	Key Parameters
`get_latest_semantic_milestone.py`	Detect latest semantic version milestone	`--owner`, `--repo`
`set_item_milestone.py`	Assign milestone to PR/issue (auto-detect)	`--item-type`, `--item-number`, `--milestone-title`

{
  "Success": true,
  "Data": { "Number": 42, "Title": "..." },
  "Error": null,
  "Metadata": { "Script": "get_pr_checks.py", "Version": "1.0.0", "Timestamp": "..." }
}

{
  "Success": false,
  "Data": null,
  "Error": { "Message": "PR not found", "Code": 2, "Type": "NotFound" },
  "Metadata": { "Script": "get_pr_checks.py", "Version": "1.0.0", "Timestamp": "..." }
}

SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT:-.claude}/skills/github/scripts"
result=$(python3 "$SCRIPTS_DIR/pr/get_pr_context.py" --pull-request 50)
echo "$result" | jq '.Data'

SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT:-.claude}/skills/github/scripts"

# Get PR context
python3 "$SCRIPTS_DIR/pr/get_pr_context.py" --pull-request 123

# Check CI status
python3 "$SCRIPTS_DIR/pr/get_pr_checks.py" --pull-request 123

# Add comment if needed
python3 "$SCRIPTS_DIR/pr/post_pr_comment_reply.py" --pull-request 123 --comment-id 456 --body "CI failures detected"

## Summary
This PR adds feature X.

Closes #123
Fixes #456

feat: Add feature X

Implements the new feature as specified.

Closes #123

Avoid	Why	Instead
Raw `gh pr view` commands	No structured output	Use `get_pr_context.py`
Raw `gh api` for comments	Doesn't preserve threading	Use `post_pr_comment_reply.py`
Replying to thread expecting auto-resolve	Replies DON'T auto-resolve threads	Use `resolve_pr_review_thread.py` after reply
Inline issue creation	Missing validation	Use `new_issue.py`
Multiple individual reactions	88% slower	Use batch mode in `add_comment_reaction.py`
Hardcoding owner/repo	Breaks in forks	Let scripts infer from `git remote`
Ignoring exit codes	Missing error handling	Check exit codes per ADR-035
Skipping idempotency markers	Duplicate comments	Use `--marker` parameter
Raw `gh notify` or notifications API	403 with app tokens	Use `get_actionable_items.py`

Document	Content
examples.md	Complete script examples
patterns.md	Reusable workflow patterns
copilot-prompts.md	Creating @copilot directives
copilot-synthesis-guide.md	Copilot context synthesis
api-reference.md	Exit codes, API endpoints, troubleshooting
`scripts/github_core/`	Shared Python helper functions

Keyword	Variations	Example
Closes	close, closed	`Closes #123`
Fixes	fix, fixed	`Fixes #456`
Resolves	resolve, resolved	`Resolves #789`

github

Installationsoptionen

Quelldateien prüfen

GitHub Skill

Triggers

GitHub Skill

Triggers

Decision Tree

Offline Invocation

Scripts

PR Operations (`scripts/pr/`)

Issue Operations (`scripts/issue/`)

Milestone Operations (`scripts/milestone/`)

Reactions (`scripts/reactions/`)

Notifications (`scripts/notifications/`)

Utilities (`scripts/utils/`)

Workflow Testing (`scripts/`)

Output Format

Process

GitHub Keywords for Issue Linking

Supported Keywords

Usage Patterns

Anti-Patterns

See Also

Verification

github

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Mehr aus diesem Repository

Mehr aus diesem Repository

GitHub Skill

Triggers

GitHub Skill

Triggers

Decision Tree

Offline Invocation

Scripts

PR Operations (scripts/pr/)

Issue Operations (scripts/issue/)

Milestone Operations (scripts/milestone/)

Reactions (scripts/reactions/)

Notifications (scripts/notifications/)

Utilities (scripts/utils/)

Workflow Testing (scripts/)

Output Format

Process

GitHub Keywords for Issue Linking

Supported Keywords

Usage Patterns

Anti-Patterns

See Also

Verification

PR Operations (`scripts/pr/`)

Issue Operations (`scripts/issue/`)

Milestone Operations (`scripts/milestone/`)

Reactions (`scripts/reactions/`)

Notifications (`scripts/notifications/`)

Utilities (`scripts/utils/`)

Workflow Testing (`scripts/`)