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:

code

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"