A proper TDD cycle implementation that won't let you cheat. It enforces five distinct phases: RED (failing test), DOMAIN review (no primitive obsession), GREEN (minimal fix), another DOMAIN pass, then COMMIT. The cycle adapts to your environment, either spawning focused subagents for each phase or falling back to sequential role-switching when delegation isn't available. The domain review step has veto power, which means you'll actually debate whether that string should be a value object instead of rubber-stamping everything. Hard gate on commits: working tree must be clean before starting the next test. If you've been doing "test after" or skipping the refactor step, this will feel constraining at first, which is the point.

skills.sh installs
195
GitHub stars
5
last updated
Aug 21, 2026

Install

$ npx -y skills add jwilger/agent-skills --skill tdd --agent claude-code

Installs into .claude/skills of the current project.

Files

TDD

Value: Feedback -- short cycles with verifiable evidence keep AI-generated code honest and the human in control. Tests express intent; evidence confirms progress.

Purpose

Teaches a five-step TDD cycle (RED, DOMAIN, GREEN, DOMAIN, COMMIT) that adapts to whatever harness runs it. Detects available delegation primitives and routes to guided mode (human drives each phase) or automated mode (system orchestrates phases). Prevents primitive obsession, skipped reviews, and untested complexity regardless of mode.

Practices

The Five-Step Cycle

Every feature is built by repeating: RED -> DOMAIN -> GREEN -> DOMAIN -> COMMIT.

  1. RED -- Write one failing test with one assertion. Only edit test files. Write the code you wish you had -- reference types and functions that do not exist yet. Run the test. Paste the failure output. Stop. Done when: tests run and FAIL (compilation error OR assertion failure).

Sponsors

Details

Repository
github.com/jwilger/agent-skills
Categories
Testing & QA, Git & Pull Requests, Documentation, Code Review & Quality, AI & Agent Building, Debugging, Automation & Workflows
First seen
Jun 3, 2026

More from jwilger/agent-skills

All 4
1charleswiltgen avataraxiom-testing-asynccharleswiltgen/axiomUse when testing async code with Swift Testing. Covers confirmation for callbacks, @MainActor tests, async/await patterns, timeout control, XCTest migration, pa176skills.sh installs
2rysweet avataroutside-in-testingrysweet/amplihackDeprecated compatibility alias for qa-team. Use when existing recipes or agents still invoke outside-in-testing by name. Redirects future work to the qa-team sk134skills.sh installs
3codeaholicguy avatartddcodeaholicguy/ai-devkitAI DevKit · Test-driven development — write a failing test before writing production code. Use when implementing new functionality, adding behavior, or fixing b0skills.sh installs
4davila7 avatarAWS Penetration Testingdavila7/claude-code-templatesThis skill should be used when the user asks to "pentest AWS", "test AWS security", "enumerate IAM", "exploit cloud infrastructure", "AWS privilege escalation",0skills.sh installs
5davila7 avatarBroken Authentication Testingdavila7/claude-code-templatesThis skill should be used when the user asks to "test for broken authentication vulnerabilities", "assess session management security", "perform credential stuf0skills.sh installs
6davila7 avatarBurp Suite Web Application Testingdavila7/claude-code-templatesThis skill should be used when the user asks to "intercept HTTP traffic", "modify web requests", "use Burp Suite for testing", "perform web vulnerability scanni0skills.sh installs