Codex Subagent
Launch OpenAI Codex CLI as a subagent (ChatGPT subscription auth, no API key). Use when delegating a self-contained coding task to Codex from another agent — parallel implementation work, a second opinion, or an independent verification pass.
Install
npx skills add davidondrej/skills --skill codex-subagentgit clone --depth 1 https://github.com/davidondrej/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/codex-subagent ~/.claude/skills/codex-subagentPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Codex CLI as a Subagent Codex CLI is OpenAI's terminal coding agent. `codex exec` runs it non-interactively: it works autonomously in a sandbox, streams progress to stderr, and prints only the final message to stdout. Auth reuses the user's ChatGPT subscription — never an API key. ## When to delegate - Self-contained coding task with clear success criteria (fix, feature, refactor, review). - Parallel work: several independent tasks at once (see Parallel runs). - Second opinion / independent verification of your own changes. Do NOT delegate tasks that need conversation context you can't fully write into the prompt. ## Preflight ```bash codex --version # missing? npm i -g @openai/codex (or: brew install --cask codex) codex login status # exit 0 + "Logged in using ChatGPT" = ready ``` Not logged in → stop and tell the user to run `codex login` (one-time browser OAuth). Never read, print, or copy credentials (`~/.codex/auth.json`). ## Launch ```bash OUT=$(mktemp /tmp/codex-out.XXXXXX) codex exec \ --cd /path/to/repo \ --model gpt-5.6-sol \ --config model_reasoning_effort=high \ --sandbox workspace-write \ --output-last-message "$OUT" \ "Full task prompt: goal, constraints, files to touch, definition of done." \ </dev/null ``` - Always use GPT 5.6 Sol (`gpt-5.6-sol`). Default reasoning effort to `high`. Pass both flags explicitly on every new Codex run. - Do NOT use Codex fast mode.
Details
- Skill name
codex-subagent- Repository
- davidondrej/skills
- Path
skills/codex-subagent/SKILL.md- License
- MIT
- Repo updated
- 17 November 2026
FAQ
What does the Codex Subagent skill do?
Launch OpenAI Codex CLI as a subagent (ChatGPT subscription auth, no API key). Use when delegating a self-contained coding task to Codex from another agent — parallel implementation work, a second opinion, or an independent verification pass.
How do I install the Codex Subagent skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add davidondrej/skills --skill codex-subagent. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Codex Subagent popular?
It lives in davidondrej/skills, which has 4,336 GitHub stars and 628 forks.
Related skills
Browser Harness
4.3kdavidondrej/skills
Direct browser control via CDP. Use when the user wants to automate, scrape, test, or interact with web pages. Connects to the user's already-running Chrome.
4x4
4.3kdavidondrej/skills
Pull 16 fast decisions out of the user with 4 sets of 4 open questions, then present an implementation plan. Only for risky changes, large product decisions, or large refactors. Run when the user types /4x4. Agents may suggest it in one line but never start it on their own.
Adr Verbatim
4.3kdavidondrej/skills
Record concise ADRs that preserve the user's decisions without conversational noise. Use for "adr-verbatim", "new ADR", "document that as an ADR", "record this decision", or supplied ADR wording.
Decisions
4.3kdavidondrej/skills
Ask the agent to list all choices it made during the current work that it is not confident of. Manual-only; the user must ask for it by name.
Better Prompt
4.3kdavidondrej/skills
Rewrite a prompt into a deeper version of the same task, the way a top professional would approach it. Use only when explicitly invoked with /better-prompt.
Effective Agent Skills
4.3kdavidondrej/skills
Write, review, and debug agent skills. Use when creating or editing SKILL.md files, improving skill structure, or diagnosing invocation and execution problems.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.