
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
スコア
総合スコア
リポジトリの品質指標に基づく評価
SKILL.mdファイルが含まれている
ライセンスが設定されている
100文字以上の説明がある
GitHub Stars 100以上
3ヶ月以内に更新がある
10回以上フォークされている
オープンIssueが50未満
プログラミング言語が設定されている
1つ以上のタグが設定されている
レビュー
レビュー機能は近日公開予定です