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.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

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).
namereviewing
descriptionGet 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 high for most review tasks—it's the sweet spot
  • Escalate to xhigh only when correctness is critical or reasoning is complex
  • Use medium or default for simple questions where speed matters
  • If xhigh times out or you're waiting too long, consider whether high suffices
# 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