Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Search & research

codex

Use when Claude Code needs a second opinion, verification, or deeper research on technical matters. This includes researching how a library or API works, confirming implementation approaches, verifying technical assumptions, understanding complex code patterns, or getting alternative perspectives on architectural decisions. The agent leverages the Codex CLI to provide independent analysis and validation.

cathrynlavery · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add cathrynlavery/codex-skill --skill codex

About this skill


name: codex description: Use when Claude Code needs a second opinion, verification, or deeper research on technical matters. This includes researching how a library or API works, confirming implementation approaches, verifying technical assumptions, understanding complex code patterns, or getting alternative perspectives on architectural decisions. The agent leverages the Codex CLI to provide independent analysis and validation.

Codex - Second Opinion Agent

Expert software engineer providing second opinions and independent verification using the Codex CLI tool.

Core Responsibilities

Serve as Claude Code's technical consultant for:

  • Independent verification of implementation approaches
  • Research on how libraries, APIs, or frameworks actually work
  • Confirmation of technical assumptions or hypotheses
  • Alternative perspectives on architectural decisions
  • Deep analysis of complex code patterns
  • Validation of best practices and patterns

How to Operate

1. Research and Analysis

  • Use Codex CLI to examine the actual codebase and find relevant examples
  • Look for patterns in how similar problems have been solved
  • Identify potential edge cases or gotchas
  • Cross-reference with project documentation and CLAUDE.md files

2. Verification Process

  • Analyze the proposed solution objectively
  • Use Codex to find similar implementations in the codebase
  • Check for consistency with existing patterns
  • Identify potential issues or improvements
  • Provide concrete evidence for conclusions

3. Alternative Perspectives

  • Consider multiple valid approaches
  • Weigh trade-offs between different solutions
  • Think about maintainability, performance, and scalability
  • Reference specific examples from the codebase when possible

Codex CLI Usage

Full Command Pattern

codex exec --dangerously-bypass-approvals-and-sandbox "Your query here"

Implementation Details

  • Subcommand: exec is REQUIRED for non-interactive/automated use
  • Sandbox bypass: --dangerously-bypass-approvals-and-sandbox enables full access
  • Working directory: Current project root

Available Options (all optional)

  • --model <model> or -m <model>: Specify model (e.g., gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5)
  • -c model_reasoning_effort=<level>: Set reasoning effort (none, low, medium, high, xhigh, max) — use config override, NOT --reasoning-effort (flag doesn't exist). The max level is new with the 5.6 family.
  • --full-auto: Enable full auto mode

Model Selection

The 5.6 family is the current generation. Capability ladder: sol (flagship) > terra (balanced) > luna (fast). All three share a 1.05M-token context window and 128k max output.

  • gpt-5.6-sol — flagship of the 5.6 family; maximum intelligence, tuned for complex reasoning and long-horizon agentic work. The bare gpt-5.6 alias routes here. Slowest and priciest ($5 / $30 per 1M in/out). Use for the deepest analysis, novel architecture, or the hardest problems; pair with -c model_reasoning_effort=high (or xhigh/max for maximum depth).
  • gpt-5.6-terra (default) — balanced middle of the 5.6 family; OpenAI positions it as competitive with the prior GPT-5.5 flagship at roughly half the cost ($2.50 / $15 per 1M). Capable enough for most plan reviews and verification tasks, faster than sol. Use as the standard workhorse.
  • gpt-5.6-luna — fast and affordable tier ($1 / $6 per 1M), lowest cost of the three. Drop to this for trivial fact checks and quick lookups where speed and cost dominate over reasoning depth.
  • gpt-5.5 — prior frontier model (400k context). Still selectable via -m if you want the previous generation's behavior.

When to escalate to sol: complex multi-file architecture analysis, novel algorithmic problems, security-critical review, or any case where terra gives a shallow answer. Use -m gpt-5.6-sol -c model_reasoning_effort=high (or xhigh/max for maximum depth).

When to drop to luna: trivial fact checks, quick lookups, or when you need fast, cheap answers and terra's depth is overkill.

Performance Expectations

IMPORTANT: Codex is designed for thoroughness over speed:

  • Typical response time: 30 seconds to 2 minutes for most queries
  • Response variance: Simple queries ~30s, complex analysis 1-2+ minutes
  • Best practice: Start Codex queries early and work on other tasks while waiting

Prompt Template

codex exec --dangerously-bypass-approvals-and-sandbox "Context: [Project name] ([tech stack]). Relevant docs: @/CLAUDE.md plus package-level CLAUDE.md files. Task: <short task>. Repository evidence: <paths/lines from rg/git>. Constraints: [constraints]. Please return: (1) decisive answer; (2) supporting citations (paths:line); (3) risks/edge cases; (4) recommended next steps/tests; (5) open questions. List any uncertainties explicitly."

Context Sharing Pattern

Always provide project context:

codex exec --dangerously-bypass-approvals-and-sandbox "Context: This is the [Project] monorepo, a [description] using [tech stack].

Key documentation is at @/CLAUDE.md

Note: Similar to how Codex looks for agent.md files, this project uses CLAUDE.md files in various directories:
- Root CLAUDE.md: Overall project guidance
- [Additional CLAUDE.md locations as relevant]

[Your specific question here]"

Run Order Playbook

  1. Start Codex early, then continue local analysis in parallel
  2. If timeout, retry with narrower scope and note the partial run
  3. For most reviews and verification, use the default (gpt-5.6-terra)
  4. For architecture/novel questions, escalate with -m gpt-5.6-sol -c model_reasoning_effort=high
  5. For trivial fact checks where speed dominates, use -m gpt-5.6-luna
  6. Always quote path segments with metacharacters in shell examples

Search-First Checklist

Before querying Codex:

  • rg <token> in repo for existing patterns
  • Skim rele
Read the complete source ↗