Codebase analysis using Codex CLI with read-only sandbox. Trigger when user needs architecture overview ("analyze this codebase with Codex", "have Codex map dependencies"), onboarding to unfamiliar code, understanding legacy systems, or identifying technical debt.
Uses Codex CLI in read-only sandbox for deep codebase analysis. Triggers when you request architecture overviews, dependency mapping, onboarding help, legacy system understanding, or technical debt assessment.
/plugin marketplace add robbyt/claude-skills/plugin install codex@robbyt-claude-skillsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Use Codex for codebase analysis with read-only sandbox.
Every prompt sent to Codex MUST include these instructions:
"You are running non-interactively as part of a script. Do not ask questions or wait for input. Do not make any changes. Provide your complete analysis immediately."
Codex is a consultant. Claude Code handles all file modifications.
If the codex MCP tool is available, use it directly:
mcp__plugin_codex_cli__codex({
"prompt": "You are running non-interactively as part of a script. Do not ask questions or wait for input. Do not make any changes. Provide your complete analysis immediately.\n\nAnalyze this project structure and architecture.",
"sandbox": "read-only",
"model": "gpt-5.2"
})
If MCP is unavailable, use shell command:
codex exec "You are running non-interactively as part of a script. Do not ask questions or wait for input. Do not make any changes. Provide your complete analysis immediately.
Analyze this project structure and architecture." --sandbox read-only -m gpt-5.2-codex 2>&1
Full project analysis:
mcp__plugin_codex_cli__codex({
"prompt": "You are running non-interactively as part of a script. Do not ask questions or wait for input. Do not make any changes. Provide your complete analysis immediately.\n\nAnalyze this project. Report on:\n- Overall architecture\n- Key dependencies\n- Component relationships\n- Potential issues",
"sandbox": "read-only",
"model": "gpt-5.2"
})
Flow mapping:
mcp__plugin_codex_cli__codex({
"prompt": "You are running non-interactively as part of a script. Do not ask questions or wait for input. Do not make any changes. Provide your complete analysis immediately.\n\nMap the authentication flow in this codebase. Identify all components involved.",
"sandbox": "read-only",
"model": "gpt-5.2"
})
Dependency analysis:
mcp__plugin_codex_cli__codex({
"prompt": "You are running non-interactively as part of a script. Do not ask questions or wait for input. Do not make any changes. Provide your complete analysis immediately.\n\nAnalyze dependencies in this project:\n- Direct vs transitive\n- Outdated packages\n- Circular dependencies\n- Bundle size impact",
"sandbox": "read-only",
"model": "gpt-5.2"
})
sandbox: "read-only" to prevent file modificationssandbox: "danger-full-access" - this is forbiddendangerouslyDisableSandbox: truereferences/setup.md for troubleshooting