# Github Code

> 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.

- Skill: `incidentfox/github-code` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add incidentfox/github-code`
- Raw SKILL.md: https://api.skillmd.com/api/skills/incidentfox/github-code/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: incidentfox (https://skillmd.com/u/incidentfox)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/incidentfox/github-code

---


# 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
```bash
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
```bash
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
```bash
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
```bash
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
```bash
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
```bash
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
```bash
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
```bash
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
```bash
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

```bash
# 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

```bash
# 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

```bash
# 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`