diegosouzapw/awesome-omni-skill / skills/ai-agents/agent-review
agent-review
VerifiedGet 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
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
# 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
# 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
# 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
# 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
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
# 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)
# 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)
# 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
-lto review specific functions without sending the entire file (saves tokens) - Use
-cto include type definitions or related files for better context - Use
-t 0.2for more focused/deterministic responses,-t 0.8for creative suggestions - Pipe code directly for quick reviews:
cat file.ts | node ... "review this"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |