review-testability

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

All Skills (Recommended)

Clone and copy all skills at once:

```bash

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:

```bash

cd codex-workflow

git pull

cp -r skills/* ~/.codex/skills/

```

Enable Skills

If skills aren't enabled yet:

```bash

codex --enable 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

```

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

```

See [CLAUDE.md](./CLAUDE.md) for skill development guidelines.

MIT

---

Ported from [claude-code-plugins](https://github.com/doodledood/claude-code-plugins) vibe-workflow