$ skilldirectory
— zsh — registry.skilldirectory.dev
skill library blog

home / Testing & QA / TDD Skill by @mattpocock

TDD Skill by @mattpocock

FREE
github stars★ 3,15,437updatedOct 2026repo@mattpocock
$git clone https://github.com/mattpocock/skills

The skill is the skills/engineering/tdd folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.

Read the opening of the original SKILL.md
# Test-Driven Development

TDD is the red → green loop. This skill is the reference that makes that loop produce tests worth keeping: what a good test is, where tests go, the anti-patterns, and the rules of the loop. Every section applies on every cycle: consult them before and during the loop, not after.

When exploring the codebase, read `GLOSSARY.md` (if it exists) so test names and interface vocabulary match the project's domain language, and respect ADRs in the area you're touching.

## What a good test is

Tests verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't. A good test reads like a specification: "user can checkout with valid cart" tells you exactly what capability exists, and it survives refactors because it doesn't care about internal structure.

See [tests.md](tests.md) for examples and [mocking.md](mocking.md) for mocking guidelines.

## Seams: where tests go
…

Excerpt only, quoted from the author's repository. Open the repository for the complete file.