Codex Workflow Skills

First-principles workflows for OpenAI Codex CLI. Built by developers who understand LLM limitations.

Who This Is For

Experienced developers frustrated by hype-driven AI coding tools. If you're tired of chasing the latest "game-changing" prompt that produces code you spend hours debugging, these skills offer a grounded alternative.

Our approach:

• Workflows designed around how LLMs actually work, not how we wish they worked
• Quality over speed—invest upfront, ship with confidence
• Simple to use, sophisticated under the hood

Installation

All Skills (Recommended)

Clone and copy all skills at once:

git clone https://github.com/doodledood/codex-workflow.git
cp -r codex-workflow/skills/* ~/.codex/skills/

Restart Codex to pick up new skills.

Individual Skills

Install specific skills using $skill-installer:

$skill-installer install https://github.com/doodledood/codex-workflow/tree/main/skills/spec
$skill-installer install https://github.com/doodledood/codex-workflow/tree/main/skills/plan
$skill-installer install https://github.com/doodledood/codex-workflow/tree/main/skills/implement

Updating

Pull latest and re-copy:

cd codex-workflow
git pull
cp -r skills/* ~/.codex/skills/

Enable Skills

If skills aren't enabled yet:

codex --enable skills

Available Skills

Core Workflow

• $spec - Interactive requirements builder through structured discovery interview
• $plan - Create implementation plans with codebase research
• $implement - Execute plans in-place with auto-fix loops and optional review workflow

Code Review

• $review - Comprehensive review orchestrator (runs all applicable reviews)
• $review-bugs - Audit for logical bugs, race conditions, edge cases
• $review-coverage - Verify test coverage for changes
• $review-type-safety - Type safety audit (TypeScript/typed languages)
• $review-maintainability - DRY violations, dead code, complexity
• $review-simplicity - Over-engineering and complexity audit
• $review-testability - Testability design patterns audit
• $review-docs - Documentation accuracy audit
• $review-agents-md-adherence - AGENTS.md compliance check

Debugging & Research

• $bugfix - Systematic bug investigation and fix workflow
• $explore-codebase - Comprehensive codebase exploration and analysis
• $research-web - Multi-wave web research with strategic source selection
• $web-research - Structured web research with hypothesis tracking

Utilities

• $fix-review-issues - Orchestrate fixing issues found by $review

Repository Structure

codex-workflow/
├── skills/              # Codex skills (SKILL.md files)
│   ├── spec/
│   ├── plan/
│   ├── implement/
│   ├── review/
│   ├── review-bugs/
│   ├── review-simplicity/
│   ├── review-testability/
│   ├── bugfix/
│   ├── explore-codebase/
│   └── ...
├── docs/                # Documentation
│   ├── CUSTOMER.md      # Who we build for
│   └── LLM_CODING_CAPABILITIES.md
├── CLAUDE.md            # Development guidelines
└── README.md

Development

See CLAUDE.md for skill development guidelines.

License

MIT

---

Ported from claude-code-plugins vibe-workflow