reviewing
Get second opinions from external models (Codex, Gemini) for adversarial review, tie-breaking, and multi-model consensus. Use when validating critical decisions or when stuck.
When & Why to Use This Skill
The Reviewing skill empowers Claude to achieve higher accuracy and reliability by seeking second opinions from external models like OpenAI Codex and Google Gemini. It is designed for adversarial review, multi-model consensus, and tie-breaking in high-stakes scenarios, ensuring that critical decisions regarding security, correctness, and architecture are validated through cross-model reasoning.
Use Cases
- Critical Code Validation: Use adversarial review to verify the security and correctness of complex code changes or sensitive logic.
- Multi-Model Tie-Breaking: Resolve uncertainty when Claude is stuck or when different reasoning paths lead to conflicting conclusions by querying Codex or Gemini.
- High-Stakes Architecture Decisions: Cross-check architectural trade-offs and design patterns with multiple high-reasoning models to ensure long-term system stability.
- Complex Reasoning Audit: Validate mathematical proofs, logical soundness, and edge-case handling using maximum reasoning effort settings (e.g., Codex xhigh reasoning).
| name | reviewing |
|---|---|
| description | Get second opinions from external models (Codex, Gemini) for adversarial review, tie-breaking, and multi-model consensus. Use when validating critical decisions or when stuck. |
Reviewing Skill
Multi-model second opinions via OpenAI Codex CLI and Google Gemini CLI.
When to Use
- Validating critical findings (security, correctness, soundness)
- Breaking ties when uncertain
- Cross-checking complex reasoning
- Architecture decisions with high stakes
Don't use for: Simple questions. Just think harder.
Priority Order
| Priority | Tool | When |
|---|---|---|
| 1st | Codex | Primary second opinion (different architecture from Claude) |
| 2nd | Gemini | Tie-breaker, or when Codex unavailable |
| 3rd | claude -p |
Fallback (fresh context, same architecture) |
Codex (OpenAI)
OpenAI's CLI for code and reasoning tasks.
Invocation
codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "<prompt>"
| Flag | Purpose |
|---|---|
-s read-only |
Required - sandbox mode, no modifications |
-m gpt-5.2 |
Best model for thorough review |
-c reasoning=xhigh |
Maximum reasoning effort |
Models
| Model | Use Case |
|---|---|
gpt-5.2 |
Default - thorough review, high-stakes |
o3 |
Complex multi-step reasoning |
o4-mini |
Quick opinions, low-stakes |
Reasoning Levels
Choose the right level for the task. Higher reasoning = more time.
| Level | Flag | Time | When to Use |
|---|---|---|---|
| xhigh | -c reasoning=xhigh |
2-5 min | Security, correctness proofs, high-stakes architecture |
| high | -c reasoning=high |
30-90 sec | Standard code review, design tradeoffs, edge cases |
| medium | -c reasoning=medium |
10-30 sec | Straightforward questions, sanity checks |
| (default) | (omit flag) | 5-15 sec | Quick opinions, simple validations |
Guidance:
- Start with
highfor most review tasks—it's the sweet spot - Escalate to
xhighonly when correctness is critical or reasoning is complex - Use
mediumor default for simple questions where speed matters - If
xhightimes out or you're waiting too long, consider whetherhighsuffices
# Most reviews
codex exec -s read-only -m gpt-5.2 -c reasoning=high "..."
# Critical/complex only
codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "..."
# Quick sanity check
codex exec -s read-only -m gpt-5.2 "..."
Gemini (Google)
Google's CLI for research and long-context analysis.
Invocation
gemini -s -m gemini-3-pro-preview "<prompt>"
| Flag | Purpose |
|---|---|
-s |
Required - sandbox mode |
-m gemini-3-pro-preview |
Best model for research/long-context |
Models
| Model | Use Case |
|---|---|
gemini-3-pro-preview |
Default - research, long context (>100k tokens) |
gemini-3-pro |
Latest capabilities (when available) |
Strengths
- Long context windows (large codebase analysis)
- Research and fact-checking
- Tie-breaking between Claude and Codex
Prompt Pattern
Always request a ---SUMMARY--- marker for reliable extraction:
codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "
<context and question>
End with:
---SUMMARY---
AGREE/DISAGREE with <topic>
Confidence: HIGH/MEDIUM/LOW
Key insight: <one sentence>
"
Output Extraction
# Run and capture
codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "..." > /tmp/opinion.log 2>&1
# Extract summary
sed -n '/---SUMMARY---/,$ p' /tmp/opinion.log
Common Patterns
Second Opinion
codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "
Problem: <describe>
Current hypothesis: <what you think>
Do you agree? What would you change?
---SUMMARY---
AGREE/DISAGREE
Confidence: HIGH/MEDIUM/LOW
Key insight: <summary>
"
Tie-Breaker (Gemini)
gemini -s -m gemini-3-pro-preview "
Analysis A (Claude): <view>
Analysis B (Codex): <view>
They disagree on: <the issue>
Which is correct?
---SUMMARY---
FAVOR: A/B/NEITHER
Reasoning: <why>
"
Multi-Model Consensus
For high-stakes decisions, query both:
# Get Codex opinion
codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "..." > /tmp/codex.log 2>&1
# Get Gemini opinion
gemini -s -m gemini-3-pro-preview "..." > /tmp/gemini.log 2>&1
# Compare summaries
sed -n '/---SUMMARY---/,$ p' /tmp/codex.log
sed -n '/---SUMMARY---/,$ p' /tmp/gemini.log
Recording Findings
Post to jwz for discovery:
# Single model
jwz post "issue:<id>" --role alice \
-m "[alice] SECOND_OPINION: codex on <topic>
Model: gpt-5.2 (reasoning=xhigh)
Agreement: AGREE|DISAGREE|PARTIAL
Key insight: <summary>"
# Multi-model consensus
jwz post "issue:<id>" --role alice \
-m "[alice] CONSENSUS: <topic>
Models: codex, gemini
Agreement: FULL|PARTIAL|SPLIT
Synthesis: <reconciled view>"
Timeouts
# Codex with xhigh reasoning can take time
timeout 600 codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "..."
# Gemini
timeout 600 gemini -s -m gemini-3-pro-preview "..."
Fallback Chain
if command -v codex >/dev/null 2>&1; then
codex exec -s read-only -m gpt-5.2 -c reasoning=xhigh "..."
elif command -v gemini >/dev/null 2>&1; then
gemini -s -m gemini-3-pro-preview "..."
else
claude -p "..."
fi