agent-review — Claude Code skill: external AI code review
Route code and prompts to external AI agents for review. Anthropic models use your local subscription via Claude Agent SDK; other models go through OpenRouter API. Useful for security audits, architecture validation, or a second opinion.
Apache-2.0 3 installs ★ 7,327 updated 2026-10-25
npx skills add civitai/civitai --skill agent-review -a claude-codeWhat agent-review does
agent-review is a Node.js command that sends code or text to an external reviewer. Four models are available: Gemini 3 Pro (default, via OpenRouter), GPT-5.1 Codex, Claude Opus, and Claude Sonnet. Anthropic models route through your subscription; others require OPENROUTER_API_KEY.
Pass code via stdin or file. Extract specific lines with -l, attach context files with -c (type definitions, hooks, schemas), adjust temperature for deterministic or creative responses. Output goes to stdout; token count and cost appear on stderr. Suppress status with --quiet.
Pick a model, add relevant context files, set temperature and system prompt, then ask your question. A single command handles partial files and multiple context sources without sending your entire codebase.
What it helps with
- Get a second opinion on code quality and security
- Validate architecture before implementation
- Audit authentication and API endpoints for vulnerabilities
- Analyze algorithm performance and time complexity
- Identify missing test cases and coverage gaps
Example prompts for the agent
- Review the auth module for security:
cat src/auth.ts | node .claude/skills/agent-review/query.mjs "Review this authentication code for security vulnerabilities" - Check a function for edge cases:
node .claude/skills/agent-review/query.mjs -m gpt -f src/parser.ts -l 50-100 "Review this parser for edge cases and error handling" - Analyze API with type definitions as context:
node .claude/skills/agent-review/query.mjs -f src/api/routes.ts -c src/types/api.ts "Review this API implementation"
How to install agent-review
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill agent-review -a claude-code2Manually: put the files in place
~/.claude/skills/agent-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agent-review/
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill agent-review -a codex2Manually: put the files in place
.agents/skills/agent-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill agent-review -a cursor2Manually: put the files in place
.cursor/skills/agent-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install civitai/civitai apps/event-engine/.claude/skills/agent-review2Manually: put the files in place
.github/skills/agent-review/SKILL.md1Skills CLI (Vercel)
npx skills add civitai/civitai --skill agent-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/civitai/civitai --path apps/event-engine/.claude/skills/agent-reviewManually: put the files in place
.devin/skills/agent-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add civitai/civitai --skill agent-review -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-review
How do I install agent-review in Claude Code?
Run npx skills add civitai/civitai --skill agent-review -a claude-code, then open ~/.claude/skills/agent-review/SKILL.md to finish setup.
What does agent-review do?
Sends code to an external AI for review. Pick a model, optionally add context files, and get feedback on security, performance, or architecture.
What API key do I need?
Anthropic models use your local Claude subscription, no key needed. Other models (GPT, Gemini) require OPENROUTER_API_KEY.
Source text
SKILL.md · Apache-2.0
--- name: agent-review description: Get external agent review and feedback. Routes Anthropic models through Claude Agent SDK (uses local subscription) and other models through OpenRouter API. Use for code review, architecture feedback, or any external consultation. --- # Agent Review Get feedback from an external AI agent. Useful for code review, architecture decisions, or getting a second opinion. ## Running Commands ```bash echo "code or prompt" | node .claude/skills/agent-review/query.mjs [options] "Your question" # or node .claude/skills/agent-review/query.mjs --file <path> [options] "Your question" ``` ### Options | Flag | Short | Description | |------|-------|-------------| | `--model <model>` | `-m` | Model or alias (default: gemini) | | `--file <path>` | `-f` | Read input from file instead of stdin | | `--lines <start-end>` | `-l` | Extract specific lines from file (e.g., 50-100) | | `--context <path>` | `-c` | Additional context file (can repeat) | | `--system <prompt>` | `-s` | Custom system prompt | | `--temperature <n>` | `-t` | Temperature 0-1 (default: 0.7) | | `--quiet` | `-q` | Suppress status messages and usage stats | | `--list` | | List available models | | `--json` | | Output raw JSON response | ### Available Models | Model ID | Aliases | Provider | Notes | |----------|---------|----------|-------| | `google/gemini-3-pro-preview` | `gemini`, `g3` | OpenRouter | Default - good for external perspective | | `openai/gpt-5.1-codex` | `gpt`, `codex`, `gpt5` | OpenRouter | Strong at code analysis | | `anthropic/claude-opus-4.5` | `opus`, `claude-opus` | Agent SDK | Uses local subscription | | `anthropic/claude-sonnet-4.5` | `sonnet`, `claude` | Agent SDK | Uses local subscription | Anthropic models route through Claude Agent SDK (uses your Claude subscription). Other models route through OpenRouter API (requires `OPENROUTER_API_KEY`). ## Environment Variables | Variable | Required | Description | |----------|----------|-------------| | `OPENROUTER_API_KEY` | For non-Anthropic models | OpenRouter API key | | `AGENT_REVIEW_DEFAULT_MODEL` | No | Override default model | ## Examples ### Code Review ```bash # Review a file for security issues cat src/server/auth.ts | node .claude/skills/agent-review/query.mjs \ "Review this authentication code for security vulnerabilities" # Review with a specific model (using alias) node .claude/skills/agent-review/query.mjs -m gpt -f src/utils/parser.ts \ "Review this parser for edge cases and error handling" ``` ### Reviewing Specific Lines ```bash # Review a specific function (lines 50-100) node .claude/skills/agent-review/query.mjs \ -f src/server/auth.ts -l 50-100 \ "Review this authentication function for security issues" # Review a single line node .claude/skills/agent-review/query.mjs \ -f src/utils/parser.ts -l 42 \ "Is this regex safe from ReDoS attacks?" ``` ### With Context Files ```bash # Review code with type definitions as context node .claude/skills/agent-review/query.mjs \ -f src/api/routes.ts \ -c src/types/api.ts \ -c src/types/models.ts \ "Review this API implementation" # Review component with its hooks as context node .claude/skills/agent-review/query.mjs \ -f src/components/UserProfile.tsx \ -c src/hooks/useUser.ts \ "Review this React component for performance issues" ``` ### Architecture Feedback ```bash # Get feedback on a proposed design cat docs/design-proposal.md | node .claude/skills/agent-review/query.mjs \ "What are the potential issues with this architecture?" ``` ### Custom System Prompt ```bash node .claude/skills/agent-review/query.mjs \ -f src/api/routes.ts \ -s "You are a security expert specializing in API design" \ "Audit this API for OWASP top 10 vulnerabilities" ``` ### Temperature Control ```bash # Lower temperature for more deterministic analysis node .claude/skills/agent-review/query.mjs -t 0.2 -f src/algo.ts \ "Analyze the time complexity" # Higher temperature for creative suggestions node .claude/skills/agent-review/query.mjs -t 0.9 -f src/ui.tsx \ "Suggest ways to improve the user experience" ``` ### Using Anthropic Models (Local Subscription) ```bash # Uses Claude Agent SDK - no API credits consumed node .claude/skills/agent-review/query.mjs -m opus -f complex-algorithm.ts \ "Analyze the time complexity and suggest optimizations" ``` ### Quiet Mode (for scripting) ```bash # Suppress all status messages, only output the response REVIEW=$(node .claude/skills/agent-review/query.mjs -q -f src/auth.ts \ "List security issues as JSON array") echo "$REVIEW" | jq . ``` ## Output The response text is written to stdout. After the response, usage stats are shown on stderr: ``` Tokens: 189 in / 871 out (1060 total) Cost: $0.0108 ``` This helps track token consumption and costs for OpenRouter requests. Use `--quiet` to suppress. ## When to Use - **Code Review**: Get a second opinion on code quality, security, or performance - **Architecture Decisions**: Validate design choices with another perspective - **Bug Analysis**: Share error context and get debugging suggestions - **Documentation Review**: Check if docs are clear and complete - **Test Coverage**: Identify missing test cases ## Tips - Default model (Gemini 3 Pro) is recommended for most external reviews - Use Anthropic models when you want consistency with Claude's style - Use `-l` to review specific functions without sending the entire file (saves tokens) - Use `-c` to include type definitions or related files for better context - Use `-t 0.2` for more focused/deterministic responses, `-t 0.8` for creative suggestions - Pipe code directly for quick reviews: `cat file.ts | node ... "review this"`
© civitai · Apache-2.0 · civitai/civitai