github-code - SKILL.md Agent Skill

name: github-code description: GitHub code search, file reading, PR review, branch/file management, and commit operations. Use when you need to search code patterns, read repository files, review pull requests, create branches, commit files, or open PRs. allowed-tools: Bash(python *)

GitHub Code & PR Integration

Authentication

Set the GITHUB_TOKEN environment variable with a GitHub personal access token or fine-grained token.

Available Scripts

All scripts are in .claude/skills/github-code/scripts/

Code Search & Reading

search_code.py - Search Code Patterns

python .claude/skills/github-code/scripts/search_code.py --query "SEARCH_TERM" [--repo OWNER/REPO]

# Examples:
python .claude/skills/github-code/scripts/search_code.py --query "authentication" --repo acme/webapp
python .claude/skills/github-code/scripts/search_code.py --query "def handle_webhook"
python .claude/skills/github-code/scripts/search_code.py --query "TODO" --repo acme/webapp --limit 50

read_file.py - Read File from Repository

python .claude/skills/github-code/scripts/read_file.py --repo OWNER/REPO --path FILE_PATH [--ref BRANCH]

# Examples:
python .claude/skills/github-code/scripts/read_file.py --repo acme/webapp --path src/main.py
python .claude/skills/github-code/scripts/read_file.py --repo acme/webapp --path package.json --ref develop

PR Review

get_pr_files.py - Get Files Changed in a PR

python .claude/skills/github-code/scripts/get_pr_files.py --repo OWNER/REPO --pr NUMBER [--show-patch]

# Examples:
python .claude/skills/github-code/scripts/get_pr_files.py --repo acme/webapp --pr 42
python .claude/skills/github-code/scripts/get_pr_files.py --repo acme/webapp --pr 42 --show-patch

get_review_context.py - Get Existing Review Context

python .claude/skills/github-code/scripts/get_review_context.py --repo OWNER/REPO --pr NUMBER [--bot-marker "Review"]

# Shows prior reviews, inline comments, and whether new commits exist since last review.
# Use before creating a review to avoid duplicating feedback.

create_review.py - Create a PR Review with Inline Comments

python .claude/skills/github-code/scripts/create_review.py --repo OWNER/REPO --pr NUMBER --body "Summary" --comments-file /tmp/comments.json
python .claude/skills/github-code/scripts/create_review.py --repo OWNER/REPO --pr NUMBER --body "LGTM" --event APPROVE

# --comments-file is a JSON array: [{"path": "src/app.py", "line": 42, "body": "Fix this"}]
# --event: COMMENT (default), APPROVE, REQUEST_CHANGES

Branch & File Management

create_branch.py - Create a New Branch

python .claude/skills/github-code/scripts/create_branch.py --repo OWNER/REPO --branch BRANCH_NAME
python .claude/skills/github-code/scripts/create_branch.py --repo OWNER/REPO --branch BRANCH_NAME --from-branch develop

create_or_update_file.py - Commit a File to a Branch

python .claude/skills/github-code/scripts/create_or_update_file.py --repo OWNER/REPO --path FILE_PATH --branch BRANCH --message "commit msg" --file /tmp/content.txt
echo "content" | python .claude/skills/github-code/scripts/create_or_update_file.py --repo OWNER/REPO --path FILE_PATH --branch BRANCH --message "commit msg"

# For updates, pass --sha with the current file SHA (get it from read_file_with_sha in github_client)

create_pull_request.py - Open a Pull Request

python .claude/skills/github-code/scripts/create_pull_request.py --repo OWNER/REPO --title "PR title" --head BRANCH_NAME
python .claude/skills/github-code/scripts/create_pull_request.py --repo OWNER/REPO --title "PR title" --head BRANCH_NAME --base main --body "Description"
python .claude/skills/github-code/scripts/create_pull_request.py --repo OWNER/REPO --title "PR title" --head BRANCH_NAME --body-file /tmp/pr_body.md

create_commit_status.py - Set Commit Status Check

python .claude/skills/github-code/scripts/create_commit_status.py --repo OWNER/REPO --sha COMMIT_SHA --state success --description "All checks passed"
python .claude/skills/github-code/scripts/create_commit_status.py --repo OWNER/REPO --sha COMMIT_SHA --state failure --description "Issues found" --context "ci/review"

# --state: error, failure, pending, success

Client Library Functions

The github_client.py module provides these functions for programmatic use:

Read Operations

Function	Purpose
`search_code(query, repo, per_page)`	Search code across repos
`read_file(owner, repo, path, ref)`	Read a file's content
`read_file_with_sha(owner, repo, path, ref)`	Read file content + SHA (needed for updates)
`get_pr(owner, repo, pr_number)`	Get PR details
`get_pr_files(owner, repo, pr_number)`	Get files changed in a PR
`list_reviews(owner, repo, pr_number)`	List reviews on a PR
`list_review_comments(owner, repo, pr_number)`	List inline review comments
`list_pr_comments(owner, repo, pr_number)`	List general PR comments
`compare_commits(owner, repo, base, head)`	Diff between commits

Write Operations

Function	Purpose
`create_review(owner, repo, pr_number, body, comments, event)`	Submit a PR review
`add_pr_comment(owner, repo, pr_number, body)`	Add a general PR comment
`create_branch(owner, repo, branch, from_branch)`	Create a new branch
`create_or_update_file(owner, repo, path, content, message, branch, sha)`	Commit a file
`create_pull_request(owner, repo, title, head, body, base)`	Open a PR
`create_commit_status(owner, repo, sha, state, description, context)`	Set commit status

Formatting Helpers

Function	Purpose
`format_pr_summary(pr)`	Format PR details for display
`format_file_changes(files)`	Format changed files list

Common Workflows

1. Review a Pull Request

# Check for prior reviews
python get_review_context.py --repo acme/webapp --pr 42

# Get the diff
python get_pr_files.py --repo acme/webapp --pr 42 --show-patch

# Read specific files for full context
python read_file.py --repo acme/webapp --path src/auth/handler.py --ref feature-branch

# Submit review with inline comments
python create_review.py --repo acme/webapp --pr 42 --body "Review summary" --comments-file /tmp/comments.json

2. Create a Fix PR

# Create a branch
python create_branch.py --repo acme/webapp --branch fix/auth-bug

# Commit the fix
python create_or_update_file.py --repo acme/webapp --path src/auth.py --branch fix/auth-bug --message "Fix auth token validation" --file /tmp/auth.py

# Open a PR
python create_pull_request.py --repo acme/webapp --title "Fix auth token validation" --head fix/auth-bug --body "Fixes #123"

3. Find and Understand Code

# Search for how authentication is implemented
python search_code.py --query "authenticate" --repo acme/webapp

# Read the file for context
python read_file.py --repo acme/webapp --path src/auth/handler.py

GitHub Code Search Syntax

Qualifier	Example	Purpose
`repo:`	`repo:acme/webapp`	Limit to repo
`path:`	`path:src/`	Filter by path
`extension:`	`extension:py`	Filter by file type
`language:`	`language:python`	Filter by language
`filename:`	`filename:config`	Filter by filename

Combine qualifiers: "def handle" language:python repo:acme/webapp