| 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
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
python .agents/skills/code-review/code_review.py review --file request.md
python .agents/skills/code-review/code_review.py review --file request.md --provider anthropic
python .agents/skills/code-review/code_review.py review --file request.md --provider openai --reasoning high
python .agents/skills/code-review/code_review.py review --file request.md --workspace ./src --workspace ./tests
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 |
python .agents/skills/code-review/code_review.py review-full \
--file request.md \
--save-intermediate \
--output-dir ./reviews
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.
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
gh CLI authenticated
- Supports
--continue for session continuity
- Models: gpt-5, claude-sonnet-4, claude-sonnet-4.5, claude-haiku-4.5
Anthropic Claude (anthropic)
- Requires
claude CLI
- Supports
--continue for session continuity
- Models: opus, sonnet, haiku, opus-4.5, sonnet-4.5, sonnet-4
OpenAI Codex (openai)
- Requires
codex CLI
- 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
gemini CLI
- 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