Agent skill · mia-cx
codex-subagents
Use when dispatching subagent work to GPT models (gpt-5.6-sol, gpt-5.5) via the Codex CLI, including inside Workflows.
What it needs
About 2k tokens when loaded.
What this skill does
Codex Subagents Two dispatch mechanisms. Model choice and when-to-escalate live in CLAUDE.md. Regular subagents: codex CLI Prompt transport: write dynamic or untrusted task text to TASKFILE with the Write tool, then pass the file on stdin. Keep task text out of the Bash command so it cannot alter shell syntax. Sandbox: -s workspace-write for implementation, -s read-only for investigation and review. Untrusted directories: outside a trusted git repo codex exits early — add --skip-git-repo-check or git init the scratch dir. Parallel: one background Bash call per task. Parallel implementation tasks get separate worktrees so edits don't collide. Follow-up to the same worker: codex exec resume --last -m gpt-5.6-sol -c modelreasoningeffort=medium "<feedback>" </dev/null — preserves that worker's context. Timeout: codex runs can exceed Bash's 10-minute default — pass an explicit timeout, or run in the background and poll for a report file. In Workflows: Sonnet wrapper Workflow/Agent model parameters only take Claude models. To use a GPT model in a workflow stage, spawn a thin Sonnet wrapper that shells out and relays: Label with a gpt-5.6-sol: prefix — the workflow UI shows the wrapper's Claude model, so the label is the only indication of the real worker. schema on the wrapper gets structured output back from codex's free-text report. isolation: 'worktree' for parallel implementation wrappers. Workflow token budgets only count Claude tokens; codex work is invisible to budget.spent(). Orchestrating 1. Decompose — each task gets acceptance criteria: observable, checkable outcomes (files changed, tests passing, behaviors demonstrated). 2. Dispatch — simple, self-contained prompts. Codex is not Claude: it does only what it's told, so drop guardrail scaffolding. Review/investigation prompts end with: "If you find nothing, say so clearly and name what you inspected." 3. Verify — check output against the acceptance criteria yourself (read the diff, run typecheck/tests). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mia-cx/codex-subagents