tdd-orchestrator — Claude Code skill: what it does, how to install
tdd-orchestrator is a Claude Code skill that orchestrates test-driven development through red-green-refactor cycles. It coordinates multi-agent testing workflows and verifies test-first compliance.
no license 51 installs updated 2026-11-17
npx claude-code-templates@latest --skill development/tdd-orchestratorWhat tdd-orchestrator does
The skill enforces disciplined test-driven workflows across development tasks. It controls the red-green-refactor progression, catches test-after anti-patterns, and guides code changes from failing tests directly to minimal passing implementations.
Workflow guidance covers both classic Chicago style TDD and London mockist approaches. The agent delegates work across unit, integration, and contract test layers while coordinating advanced techniques such as property-based runs with Hypothesis or fast-check.
Legacy code characterization relies on golden master verification to preserve existing behavior during deep rewrites. Detailed step-by-step procedures reside in resources/implementation-playbook.md.
What it helps with
- orchestrate disciplined red-green-refactor cycles when adding features
- delegate unit, integration, and end-to-end tests across specialized agents
- characterize legacy software using golden master tests before refactoring
- introduce property-based testing runs via Hypothesis or fast-check
Example prompts for the agent
- Drive the payment service implementation using strict red-green-refactor cycles.
- Break down user authentication using classic Chicago TDD without unnecessary mocks.
- Create golden master characterization tests for the legacy report generator before refactoring.
How to install tdd-orchestrator
1claude-code-templates
npx claude-code-templates@latest --skill development/tdd-orchestrator2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a claude-code3Manually: put the files in place
~/.claude/skills/tdd-orchestrator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tdd-orchestrator/
1Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a codex2Manually: put the files in place
.agents/skills/tdd-orchestrator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a cursor2Manually: put the files in place
.cursor/skills/tdd-orchestrator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates cli-tool/components/skills/development/tdd-orchestrator2Manually: put the files in place
.github/skills/tdd-orchestrator/SKILL.md1Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a gemini-cli2Platform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/tdd-orchestratorManually: put the files in place
.devin/skills/tdd-orchestrator/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tdd-orchestrator
How to install tdd-orchestrator in Claude Code?
Run npx claude-code-templates@latest --skill development/tdd-orchestrator. You can also install it using npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a claude-code.
What does tdd-orchestrator do?
It manages test-driven development processes, verifies that tests precede code implementation, and coordinates multi-agent test execution.
Which TDD methodologies does tdd-orchestrator support?
It supports both Chicago and London TDD schools, alongside Acceptance Test-Driven Development and Behavior-Driven Development flows.