
code-review
by grahama1970
SKILL.md
name: code-review description: > Submit code review requests to multiple AI providers (GitHub Copilot, Anthropic Claude, OpenAI Codex, Google Gemini) and get patches back. Use when user says "code review", "review this code", "get a patch for", or needs AI-generated unified diffs for code fixes. allowed-tools: Bash, Read triggers:
- code review
- review this code
- get a patch
- copilot review
- generate diff
- review request
- full review metadata: short-description: Multi-provider AI code review CLI
Code Review Skill
Submit structured code review requests to multiple AI providers and get unified diffs back.
Supported Providers
| Provider | CLI | Default Model | Notes |
|---|---|---|---|
github | copilot | gpt-5 | GitHub Copilot (default) |
anthropic | claude | sonnet | Claude CLI |
openai | codex | gpt-5.2-codex | OpenAI Codex (high reasoning default) |
google | gemini | gemini-2.5-flash | Gemini CLI |
Prerequisites
# Check provider CLI availability
python .agents/skills/code-review/code_review.py check
python .agents/skills/code-review/code_review.py check --provider anthropic
python .agents/skills/code-review/code_review.py check --provider openai
python .agents/skills/code-review/code_review.py check --provider google
Quick Start
# Single-step review (default: github/copilot)
python .agents/skills/code-review/code_review.py review --file request.md
# Use different provider
python .agents/skills/code-review/code_review.py review --file request.md --provider anthropic
# OpenAI with high reasoning
python .agents/skills/code-review/code_review.py review --file request.md --provider openai --reasoning high
# Include uncommitted local files via workspace
python .agents/skills/code-review/code_review.py review --file request.md --workspace ./src --workspace ./tests
# Full 3-step pipeline (generate -> judge -> finalize)
python .agents/skills/code-review/code_review.py review-full --file request.md
Commands
check
Verify provider CLI and authentication.
| Option | Short | Description |
|---|---|---|
--provider | -P | Provider to check (default: github) |
review
Submit a single code review request.
| Option | Short | Description |
|---|---|---|
--file | -f | Markdown request file (required) |
--provider | -P | Provider: github, anthropic, openai, google |
--model | -m | Model (provider-specific, uses default if not set) |
--add-dir | -d | Add directory for file access |
--workspace | -w | Copy local paths to temp workspace (for uncommitted files) |
--reasoning | -R | Reasoning effort: low, medium, high (openai only) |
--raw | Output raw response without JSON | |
--extract-diff | Extract only the diff block |
review-full
Run iterative code review pipeline.
Pipeline (per round):
- Generate - Initial review with diff and clarifying questions
- Judge - Reviews output, answers questions, provides feedback
- Finalize - Regenerates diff incorporating feedback
| Option | Short | Description |
|---|---|---|
--file | -f | Markdown request file (required) |
--provider | -P | Provider: github, anthropic, openai, google |
--model | -m | Model for all steps |
--add-dir | -d | Add directory for file access |
--workspace | -w | Copy local paths to temp workspace |
--reasoning | -R | Reasoning effort: low, medium, high (openai only) |
--rounds | -r | Iteration rounds (default: 2) |
--save-intermediate | -s | Save step outputs |
--output-dir | -o | Directory for output files |
# Full pipeline with intermediate files saved
python .agents/skills/code-review/code_review.py review-full \
--file request.md \
--save-intermediate \
--output-dir ./reviews
# Creates: round1_step1.md, round1_step2.md, round1_final.md, round1.patch
build
Build a request markdown file from options.
| Option | Short | Description |
|---|---|---|
--title | -t | Title describing the fix (required) |
--repo | -r | Repository owner/repo (required) |
--branch | -b | Branch name (required) |
--path | -p | Paths of interest (repeatable) |
--summary | -s | Problem summary |
--objective | -o | Objectives (repeatable) |
--acceptance | -a | Acceptance criteria (repeatable) |
--touch | Known touch points (repeatable) | |
--output | Write to file instead of stdout |
bundle
Bundle request for copy/paste into GitHub Copilot web.
IMPORTANT: Copilot web can only see committed & pushed changes!
| Option | Short | Description |
|---|---|---|
--file | -f | Markdown request file (required) |
--repo-dir | -d | Repository directory (for git status check) |
--output | -o | Output file (default: stdout) |
--clipboard | -c | Copy to clipboard (xclip/pbcopy) |
--skip-git-check | Skip git status verification |
models
List available models for a provider.
| Option | Short | Description |
|---|---|---|
--provider | -P | Provider to list models for |
template
Print the example review request template.
find
Search for review request markdown files.
Workspace Feature
The --workspace flag copies local files to a temporary directory that providers can access.
This is useful when you have uncommitted changes that aren't visible to remote-based providers.
# Copy src/ and tests/ to temp workspace
python .agents/skills/code-review/code_review.py review \
--file request.md \
--workspace ./src \
--workspace ./tests
The workspace is automatically cleaned up after the review completes.
Provider-Specific Notes
GitHub Copilot (github)
- Requires
ghCLI authenticated - Supports
--continuefor session continuity - Models: gpt-5, claude-sonnet-4, claude-sonnet-4.5, claude-haiku-4.5
Anthropic Claude (anthropic)
- Requires
claudeCLI - Supports
--continuefor session continuity - Models: opus, sonnet, haiku, opus-4.5, sonnet-4.5, sonnet-4
OpenAI Codex (openai)
- Requires
codexCLI - Default reasoning: high (best results)
- Models: gpt-5, gpt-5.2, gpt-5.2-codex, o3, o3-mini
- Does NOT support
--continue(session context lost between rounds)
Google Gemini (google)
- Requires
geminiCLI - Models: gemini-3-pro, gemini-3-flash, gemini-2.5-pro, gemini-2.5-flash, auto
- Does NOT support
--continue(use /chat save/resume in interactive mode)
Project Agent Workflow (Recommended)
The intended workflow is for the project agent (Claude) to interpret and apply suggestions:
User asks for code review
|
Project agent creates review request (follows template)
|
review/review-full sends to provider CLI
|
Project agent parses output, decides what to apply
|
Project agent uses Edit tool to apply changes it concurs with
|
If unclear, agent asks provider (another round) or the user
Why this approach:
- Patch format may be malformed (won't
git apply) - Project agent can exercise judgment on suggestions
- Agent can ask clarifying questions back to provider
- Same workflow humans use, but automated
Dependencies
pip install typer rich
Score
Total Score
Based on repository quality metrics
SKILL.mdファイルが含まれている
ライセンスが設定されている
100文字以上の説明がある
GitHub Stars 100以上
3ヶ月以内に更新がある
10回以上フォークされている
オープンIssueが50未満
プログラミング言語が設定されている
1つ以上のタグが設定されている
Reviews
Reviews coming soon