Skip to content
SkillMixed4,167 tokens in use

Codex Agents

Use the Codex CLI as a peer, a builder or a fresh reviewer, through a wrapper that remembers the session, model and sandbox across turns.

680 stars on the repository MIT Licensephuryn/product-engineering · agent-teams/skills/codex-agents
npx skills add phuryn/product-engineering
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Codex Agents costs

43tokens idle
4,167tokens in use
6,939tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/codex.py.

Touches

shelldetectedwrites filesdetectedgitdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure19/25
  • Examples12/15
  • Output15/15
  • Size15/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 29
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 29

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity100
  • Maintenance100
  • Community44
  • Maturity4
  • Momentum40

Codex Agents covers requests like “ask Codex”, “check with Codex”, handing Codex a build or review, or being stuck between two framings. It treats Codex as a peer with the same standing as Claude: argue decisions with it, let it build a stage, and let it review code it did not write.

The wrapper codex.py resumes the recorded session per directory and re-sends model, effort and sandbox on every turn, since a resume otherwise falls back to the config defaults.

What You Get

  • codex.py, a Python wrapper that records session id, model and sandbox and resumes them
  • Dispatch rules for briefs, instruction-file budgets and installed skill packs inside Codex
  • Guidance on resume versus fresh sessions and one worktree per parallel build
  • Warnings about sandbox limits for git and browser tests, observed and dated
  • Binary lookup order: CODEX_BIN, codex on PATH, then the VS Code extension bundle

Common Use Cases

  • Debating a load-bearing decision with Codex before building
  • Handing Codex a build stage in its own worktree
  • Running Codex as the fresh reviewer for a release
  • Resuming an earlier Codex session by id

What Makes It Unique

The skill is built around what goes wrong silently: a resume that drops the model, a resume that drops the sandbox so a build lands read-only and changes nothing, an instruction file cut by Codex’s context budget, and a round that argues a verdict while writing no files. The wrapper prints the reported model and sandbox after each run, and the skill requires checking git status before believing a build round happened.

Under The Hood

The skill is instructions, references and a Python wrapper that uses the standard library. The wrapper runs the Codex command-line tool as a subprocess in the repository you name, with the brief read from a file, and stores a marker file with the active session. Depending on the sandbox you choose, Codex can write files and run commands, including tests, in that repository. The skill also tells the agent to run codex plugin commands to check or install skill packs. It does not fetch web pages itself.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers