# test-driven-development

> Claude/Codex skill by [@addyosmani](https://omgskills.com/library/addyosmani/index.md) · 81k stars · Updated 2026-07-26

Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.

Tags: agent-skills, antigravity, claude-code, codex, cursor, skills

## Install

```sh
git clone https://github.com/addyosmani/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/test-driven-development ~/.claude/skills/test-driven-development
```

## From README

Test-Driven Development Overview Write a failing test before writing the code that makes it pass. For bug fixes, reproduce the bug with a test before attempting a fix. Tests are proof — "seems right" is not done. A codebase with good tests is an AI agent's superpower; a codebase without tests is a liability. When to Use Implementing any new logic or behavior Fixing any bug (the Prove-It Pattern) Modifying existing functionality Adding edge case handling Any change that could break existing behavior When NOT to use: Pure configuration changes, documentation updates, or static content changes that have no behavioral impact. Related: For browser-based changes, combine TDD with runtime verification using Chrome DevTools MCP — see the Browser Testing section below. Discover the Stack First The TDD cycle is universal; the commands are not.

## Links

- HTML page: https://omgskills.com/skills/addyosmani/agent-skills/test-driven-development/
- GitHub: https://github.com/addyosmani/agent-skills
- Author: [@addyosmani](https://omgskills.com/library/addyosmani/index.md)

## More from this repo

- [api-and-interface-design](https://omgskills.com/skills/addyosmani/agent-skills/skills/api-and-interface-design/index.md) — Guides stable API and interface design.
   - [@addyosmani](https://omgskills.com/library/addyosmani/index.md) · 93k stars
- [constraint-driven-development](https://omgskills.com/skills/addyosmani/agent-skills/skills/constraint-driven-development/index.md) — Establishes a project's quality bar as a written contract and stops agents quietly lowering it.
   - [@addyosmani](https://omgskills.com/library/addyosmani/index.md) · 91k stars
- [doubt-driven-development](https://omgskills.com/skills/addyosmani/agent-skills/skills/doubt-driven-development/index.md) — Subjects every non-trivial decision to a fresh-context adversarial review before it stands.
   - [@addyosmani](https://omgskills.com/library/addyosmani/index.md) · 87k stars