codex
Run Codex CLI (exec, resume) for parallel work, delegating tasks to another model, or background code generation. Handles code analysis, refactoring, and automated editing. Includes Spark vs standard guidance. Triggers: "codex", "run codex", "use codex to".
- Installs
- 209
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/poteto/noodle --skill codex- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads codex automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Codex
Profiles
- (no profile) — read-only analysis (no compilation, no tests)
--profile edit— local edits, build, or test (workspace-write, full-auto)--profile full— network or broad filesystem access (danger-full-access, full-auto)
Use --profile edit whenever the task involves go test, go build, or any command that writes build artifacts. The default read-only sandbox blocks all writes including compiler temp dirs.
For complex tasks, add --config model_reasoning_effort="xhigh".
Model Selection
Default to the project model in .codex/config.toml (gpt-5.4).
Use --model gpt-5.3-codex-spark for speed-first interactive work:
- tight back-and-forth iteration
- quick bug fixes and targeted edits
- small-to-medium refactors or UI tweaks
- rapid prototyping where frequent redirect/interrupt is expected
Stay on default gpt-5.4 for depth-first work:
- long autonomous runs
- broad multi-file changes with heavy reasoning
- test-heavy or verification-heavy tasks
- higher correctness/risk surfaces where deeper reasoning is worth the extra latency
If the user explicitly requests a model, follow the user's request.
Commands
Project defaults in .codex/config.toml. Always include --skip-git-repo-check and 2>/dev/null. Only override model when the user explicitly requests it, or when the task clearly fits the Spark speed-first criteria above.
| Use case | Command |
|---|---|
| Read-only analysis | codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null |
| Speed-first interactive loop (Spark) | add --model gpt-5.3-codex-spark |
| Apply local edits | add --profile edit |
| Network / broad access | add --profile full |
| Resume session | echo "prompt" | codex exec --skip-git-repo-check -o "$CODEX_OUT" resume --last 2>/dev/null |
Create a temp file for output before running: CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX). Read the result from $CODEX_OUT after completion.
Run with Bash run_in_background: true. Monitor via TaskOutput with block: true, timeout: 600000 — do NOT use sleep commands to poll. Read the -o file for the final answer.
Resuming
Don't pass model/effort/sandbox flags when resuming — original session settings carry over. -o is safe to include.
Conventions
This is a Go project. Use go test, go build, go vet in prompts. Codex workers don't receive CLAUDE.md or hooks, so project conventions must be explicit.
Post-Execution Verification
Always verify Codex output via git diff --stat — never trust the worker's self-reported file list. Codex workers may make out-of-scope changes (deleting files, reverting unrelated code, removing test functions). The completion promise may list only intended files while omitting destructive side effects.
When other work exists in the same codebase, include explicit "DO NOT modify or delete" file lists in the prompt. The positive instruction ("only touch these files") is insufficient — Codex interprets "clean up" broadly.
Per [[principles/prove-it-works]]: trust artifacts, not self-reports.
Worktree Usage
With -C <worktree-dir>, the worktree has its own git index. .claude/ may symlink to .agents/ — use .agents/ paths for git operations.
FAQ
What does the codex skill do?
Run Codex CLI (exec, resume) for parallel work, delegating tasks to another model, or background code generation. Handles code analysis, refactoring, and automated editing. Includes Spark vs standard guidance. Triggers: "codex", "run codex", "use codex to".
How do I install codex?
Run npx skills add https://github.com/poteto/noodle --skill codex in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/codex/ (personal) or .claude/skills/codex/ (project).
Which AI agents can use codex?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is codex safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains codex?
It is published by poteto in poteto/noodle. It has 209 recorded installs.
More from poteto/noodle
adversarial-review
poteto/noodle
Adversarial code review using cross-model approach. Spawns reviewers on the opposing model (Claude uses Codex, Codex uses Claude) to challenge work from distinct critical lenses. Produces a synthesized verdict with findings and lead judgment. Triggers: "adversarial review".
unslop
poteto/noodle
Remove AI writing patterns from prose. Use for docs, READMEs, blog posts, any non-code text that should sound human. Triggers: "unslop", "humanize", "make this sound human", "clean up this writing", "edit for voice", "de-AI this text".
ts-best-practices
poteto/noodle
Open the skill to read its SKILL.md instructions.
debugging
poteto/noodle
Systematic root-cause debugging methodology. Use for any technical problem — errors, failures, unexpected behavior, or when stuck. Triggers: "debug", "fix this", "what's wrong", "investigate".
commit
poteto/noodle
Create conventional commit messages. Use when the user says "commit this", "save changes", "git commit", asks to commit code, write a commit message, or format git history. Follows conventional commits specification.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.