Agent-Skills.md

Agent Skills: Codex Agent

Delegate coding tasks to Codex CLI. Use when executing code changes, reviews, debugging, or parallelizing tasks via Codex.

UncategorizedID: ianchenx/ian-skills/codex-agent

Repository

ianchenx/ian-skills
ianchenx
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ianchenx/ian-skills/tree/HEAD/skills/codex-agent

Skill Files

Browse the full folder contents for codex-agent.

Download Skill

Loading file tree…

skills/codex-agent/SKILL.md

Skill Metadata

Name
codex-agent
Description
Delegate coding tasks to Codex CLI. Use when executing code changes, reviews, debugging, or parallelizing tasks via Codex.

Codex Agent

You are the orchestrator. Codex is the executor. You plan, decompose, and review. Codex writes code, refactors, and fixes bugs.

Do not write code directly — always delegate via codex-async, even for complex changes. If a task feels too complex for a single Codex dispatch, break it into smaller subtasks rather than writing code yourself. Writing code directly defeats the purpose of this skill: parallel execution, separation of concerns, and the ability to review Codex's output critically as an independent reviewer.

Script Directory

Agent Execution Instructions:

  1. Determine this SKILL.md file's directory path as {baseDir}
  2. Script path = {baseDir}/scripts/codex-async
  3. Run chmod +x {baseDir}/scripts/codex-async once
  4. Replace all {baseDir} in this document with the actual path

Script Reference: | Script | Purpose | |--------|---------| | scripts/codex-async | Async task manager wrapping codex exec |

Verify: {baseDir}/scripts/codex-async help

Workflow

1. Plan

Analyze the request. Decompose into discrete steps. Identify dependencies — steps without dependencies run in parallel.

2. Dispatch

# Single task
{baseDir}/scripts/codex-async run --cd "$PWD" "Implement JWT auth in src/auth.ts"

# Parallel — launch multiple in one turn
{baseDir}/scripts/codex-async run --cd "$PWD" "Implement auth module"
{baseDir}/scripts/codex-async run --cd "$PWD" "Write tests for utils"
{baseDir}/scripts/codex-async run --cd "$PWD" "Refactor error handling"

3. Wait & Collect

{baseDir}/scripts/codex-async wait <id1> <id2> --timeout 300
{baseDir}/scripts/codex-async result <id>

4. Review

Read results critically. If not satisfied:

  • Resume: {baseDir}/scripts/codex-async resume <id> "Fix null input handling"
  • Or re-dispatch with clearer instructions

Verification

After Codex completes, verify before reporting done:

  • Run project tests if they exist
  • Check git diff for unintended changes
  • Confirm the implementation matches the plan

Definition of done: tests pass, no unintended side effects, plan fulfilled.

Options Reference

Run {baseDir}/scripts/codex-async help for full CLI reference.

| Option | Description | |---|---| | --model | Model: gpt-5.3-codex (default, optimized for code), gpt-5.4 (general reasoning) | | --reasoning | Reasoning effort: high (default), xhigh, medium, low | | --sandbox | Sandbox: workspace-write (default), read-only, danger-full-access | | --cd | Working directory for the task |

Use defaults unless you have a reason to change. For simple mechanical tasks (renaming, formatting), --reasoning medium saves tokens. Use --sandbox read-only for review-only tasks, danger-full-access only when the task needs to install dependencies or access the network.

Error Handling

  • Task exits non-zero → read result, diagnose, retry with clearer prompt
  • Task hangs → {baseDir}/scripts/codex-async kill <id> and retry
  • 3 retries fail → escalate to user with diagnosis