Agent skill

Codex

by poteto in poteto/noodle

Run Codex CLI (exec, resume) for parallel work, delegating tasks to another model, or background code generation.

MITAuto-check passedDevelopment

Install Codex

skills CLI
$ npx skills add poteto/noodle --skill codex -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install poteto/noodle codex --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/poteto/noodle.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/codex .claude/skills/codex && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
codex
GitHub stars
420
Token cost
~894 tokens
SKILL.md length
413 words
Files
1
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

Run Codex CLI (exec, resume) for parallel work, delegating tasks to another model, or background code generation.

  • Tasks that involve Refactoring
  • SKILL.md covers Profiles, Model Selection, Commands and Resuming, plus 3 more sections
  • Calls go, codex and git

What it does

Codex is an agent skill from poteto/noodle. 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".

Its SKILL.md is about 890 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Refactoring. It works with OpenAI and Git. The repository describes itself as: Orchestrate agents using skills. The licence is MIT.

When your agent uses it

  • Tasks that involve Refactoring

Example prompts

  • “run codex”
  • “use codex to”
  • “/codex”

What it can do on your machine

Read from SKILL.md and the folder at commit 82d2921. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go
    • codex
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Codex loads about 894 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 413 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~894

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from poteto/noodle at commit 82d2921, republished under its MIT licence (© poteto). 413 words, ~894 tokens.

Download SKILL.mdSave it as .claude/skills/codex/SKILL.md (or your agent's skills folder).
name
codex
description
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".

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 caseCommand
Read-only analysiscodex 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 editsadd --profile edit
Network / broad accessadd --profile full
Resume sessionecho "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.

Show full SKILL.md (152 more words)Show less

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.

© poteto, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/codex of poteto/noodle.

Open the folder on GitHubat commit 82d2921

Compare with similar skills

Codex next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Codex compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex this skillpoteto/noodle420—~894Automated safety check: PassMIT
Codexskills-directory/skill-codex1.5k3 repos~1.8kAutomated safety check: PassMIT
Codexdavila7/claude-code-templates32k4 repos~1.3kAutomated safety check: PassMIT
Open Code Review CLIalibaba/open-code-review44k—~3.1kAutomated safety check: PassApache-2.0
Changeset Validationopenai/openai-agents-js3.9k—~607Automated safety check: PassMIT
Openai Security Ownership Maptrailofbits/skills-curated5125 repos~2.2kAutomated safety check: NotesCC-BY-SA-4.0

Similar skills

  • Codex

    skills-directory/skill-codex

    A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing

    1.5k GitHub starsUsed in 3 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Codex

    davila7/claude-code-templates

    A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing.

    32k GitHub starsUsed in 4 repos~1.3k tokens
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    44k GitHub stars~3.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Changeset Validation

    openai/openai-agents-js

    Official

    Validate changesets in openai-agents-js using LLM judgment against git diffs (including uncommitted local changes).

    3.9k GitHub stars~607 tokensUpdated today
    DevelopmentAuto-check passed
  • Openai Security Ownership Map

    trailofbits/skills-curated

    Official

    Analyze git repositories to build a security ownership topology (people-to-file), compute bus factor and sensitive-code ownership, and export CSV/JSON for graph databases and visualization.

    512 GitHub starsUsed in 5 repos~2.2k tokens
    DevelopmentAuto-check: notes
  • Nexus Mapper

    Haaaiawd/Nexus-skills

    Generate a persistent .nexus-map/ knowledge base that lets any AI session instantly understand a codebase's architecture, systems, dependencies, and change hotspots.

    166 GitHub starsUsed in 1 repo~2.5k tokens
    DevelopmentAuto-check: notes

More from poteto/noodle

All 26 skills in this repo
  • Meditate

    poteto/noodle

    Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities.

    420 GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Ruminate

    poteto/noodle

    Mine past Claude Code and Codex conversations for uncaptured patterns, corrections, and knowledge.

    420 GitHub stars~1.4k tokensUpdated 6 mo ago
    Auto-check passed
  • Ast Grep

    poteto/noodle

    Structural code search via ast-grep — use when code shape and element relationships matter, not just text.

    420 GitHub stars~531 tokensUpdated 6 mo ago
    Auto-check passed
  • Execute

    poteto/noodle

    Implementation methodology for executing tasks. An agent skill from poteto/noodle.

    420 GitHub stars~989 tokensUpdated 6 mo ago
    Auto-check passed
  • Noodle

    poteto/noodle

    Operate the Noodle CLI — explain commands, find flags, create/edit .noodle.toml config.

    420 GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Plan

    poteto/noodle

    Systematic planning for medium-to-large tasks. An agent skill from poteto/noodle.

    420 GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Works with

Categories

Questions about Codex

What does Codex do?

Run Codex CLI (exec, resume) for parallel work, delegating tasks to another model, or background code generation. Codex is an agent skill from poteto/noodle. Run Codex CLI (exec, resume) for parallel work, delegating tasks to another model, or background code generation.

When should I use Codex?

Codex fits situations like: tasks that involve Refactoring.

How do I install Codex in Claude Code?

Run `npx skills add poteto/noodle --skill codex -a claude-code`. Or copy the skill folder (.agents/skills/codex in poteto/noodle) into .claude/skills/codex in your project. Claude Code loads it when a task matches its description.

How do I install Codex in Codex?

Run `npx skills add poteto/noodle --skill codex -a codex`. Or copy the skill folder (.agents/skills/codex in poteto/noodle) into .agents/skills/codex in your project. Codex loads it when a task matches its description.

Can I use Codex in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add poteto/noodle --skill codex -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex, .gemini/skills/codex, .github/skills/codex and .opencode/skills/codex in your project.

What does Codex need to run?

Going by SKILL.md and its folder, Codex needs the command-line tools its instructions call (go, codex and git).

Does Codex access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Codex safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Codex use?

Codex is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codex use?

About 894 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Codex?

Skills that share tags, products or a category with Codex: Codex (skills-directory/skill-codex, 1.5k stars), Codex (davila7/claude-code-templates, 32k stars), Open Code Review CLI (alibaba/open-code-review, 44k stars) and Changeset Validation (openai/openai-agents-js, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex?

poteto (a GitHub user) maintains it in poteto/noodle, which has 420 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on March 19, 2026.

Source: poteto/noodle on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.