codex/SKILL.md
Use when user wants to delegate a task to OpenAI Codex CLI. Triggers on "ask codex", "have codex", "codex:", "send to codex", "let codex", "run codex". Delegates via subagent to keep main context clean.
npx skillsauth add aromanarguello/roman-skills codexInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Delegate tasks to OpenAI's Codex CLI via a subagent. Codex runs non-interactively and results are summarized back.
Is this a code review request?
│
┌────┴────┐
yes no
│ │
▼ ▼
codex codex exec
review --sandbox read-only
Dispatch a single Bash subagent (Task tool) with the appropriate command. This keeps all Codex output isolated from the main context window.
Use codex review which has specialized review behavior:
Task tool:
subagent_type: Bash
model: haiku
description: "Codex review"
prompt: |
Run this command and return the full output:
codex review {FLAGS} "{INSTRUCTIONS}" -o /tmp/codex-out.txt 2>/dev/null; cat /tmp/codex-out.txt
Flags:
- --uncommitted → review staged/unstaged/untracked changes
- --base BRANCH → review changes against a base branch
- --commit SHA → review a specific commit
Default to --uncommitted if user didn't specify.
Return the complete review output.
Use codex exec in read-only sandbox:
Task tool:
subagent_type: Bash
model: haiku
description: "Codex: {brief task}"
prompt: |
Run this command and return the full output:
codex exec "{USER_PROMPT}" --sandbox read-only -C "{WORKING_DIR}" -o /tmp/codex-out.txt 2>/dev/null; cat /tmp/codex-out.txt
Return the complete output.
User must explicitly ask for write access. Use --sandbox workspace-write instead of read-only:
codex exec "{PROMPT}" --sandbox workspace-write -C "{WORKING_DIR}" -o /tmp/codex-out.txt 2>/dev/null; cat /tmp/codex-out.txt
| User Says | Route To | Flags |
|-----------|----------|-------|
| "ask codex to review" | codex review | --uncommitted |
| "codex review against main" | codex review | --base main |
| "codex review commit abc123" | codex review | --commit abc123 |
| "ask codex to analyze/explain/plan" | codex exec | --sandbox read-only |
| "have codex fix/refactor/implement" | codex exec | --sandbox workspace-write |
| Mistake | Fix |
|---------|-----|
| Running codex in main context | Always use a Bash subagent via Task tool |
| Forgetting 2>/dev/null | Codex thinking tokens flood context without this |
| Forgetting -o flag | Without it, output mixes with metadata noise |
| Using interactive mode | Always use codex exec or codex review, never bare codex |
| Hardcoding model | Let user's codex config choose the model |
development
Use when the user wants to brainstorm, stress-test, sharpen a plan, explore options, decide what to build, or says "grill me", "/grill-me", "help me think through", "sharpen this idea", or "what should I build".
development
Use at end of coding sessions to find and eliminate duplicated code, dead code, and unnecessary abstractions. Also use when codebase feels cluttered or when you suspect copy-paste patterns have accumulated.
development
Use when you have 2+ independent tasks to run concurrently without a formal plan. Triggers on "parallel research", "parallel subagents", "explore in parallel", "investigate multiple", "run tests in parallel". NOT for plan execution (use subagent-driven-development instead)
testing
Pre-merge review that runs PR quality, tech debt, security, regression, and performance analysis in parallel via general-purpose agents, aggregates findings into a unified prioritized report, then auto-fixes mechanical issues. Use when the user says "final review", "pre-merge review", "run all reviews", or wants a comprehensive check before merging. Defaults to all reviewers; accepts args to run a subset (e.g., `/final-review security techdebt`).