test-driven-dev SKILL.md skillA

test-driven-dev from zebbern/claude-code-guide is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zebbern/claude-code-guide/test-driven-dev@git:20260531.164971d

Pins git:20260531.164971d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zebbern/claude-code-guide
Path
skills/test-driven-dev/SKILL.md
Versions recorded
1
Latest version
git:20260531.164971d, committed May 31, 2026
Size
4,223 bytes
Repository stars
4,700
License
MIT

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Test-Driven Development

## Philosophy

**Core principle**: Tests should verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't.

**Good tests** are integration-style: they exercise real code paths through public APIs. They describe _what_ the system does, not _how_ it does it. A good test reads like a specification - "user can checkout with valid cart" tells you exactly what capability exists. These tests survive refactors because they don't care about internal structure.

**Bad tests** are coupled to implementation. They mock internal collaborators, test private methods, or verify through external means (like querying a database directly instead of using the interface). The warning sign: your test breaks when you refactor, but behavior hasn't changed. If you rename an internal function and tests fail, those tests were testing implementation, not behavior.

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

## Anti-Pattern: Horizontal Slices
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zebbern/claude-code-guide/test-driven-dev@sha256:ee6b8b1f77ee8e14

The line at the top of this page pins the label git:20260531.164971d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_f2s52ec6tox6cl64.svg)](https://markdownregistry.com/a/art_f2s52ec6tox6cl64)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 31, 2026.

versioncommittedcommitsizeaudit
git:20260531.164971d latest2026-05-31 164971d 4,223 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4223 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

zebbern/claude-code-guide · 4,700 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_f2s52ec6tox6cl64
GET https://markdownregistry.com/api/v1/resolve?ref=zebbern/claude-code-guide/test-driven-dev
GET https://markdownregistry.com/api/v1/blob/ee6b8b1f77ee8e143ff1d877d67858258c0543eb88847a993b612b079ce5c27f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from zebbern/claude-code-guide

academic-paper-reviewer SKILL.md skill
zebbern/claude-code-guide · skills/academic-paper-reviewer/SKILL.md · Simulates academic peer review, evaluating papers across Originality, Methodology, Results, and Writing to provide…
git:20260531.164971d · audit A · 4,700 stars
active-directory-attacks SKILL.md skill
zebbern/claude-code-guide · skills/active-directory-attacks/SKILL.md · This skill should be used when the user asks to "attack Active Directory", "exploit AD", "Kerberoasting", "DCSync"…
v1.1 · audit A · 4,700 stars
api-fuzzing-bug-bounty SKILL.md skill
zebbern/claude-code-guide · skills/api-fuzzing-bug-bounty/SKILL.md · This skill should be used when the user asks to "test API security", "fuzz APIs", "find IDOR vulnerabilities", "test…
v1.1 · audit C · 4,700 stars
api-shape-explorer SKILL.md skill
zebbern/claude-code-guide · skills/api-shape-explorer/SKILL.md · Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to…
git:20260531.164971d · audit A · 4,700 stars
audit-flow SKILL.md skill
zebbern/claude-code-guide · skills/audit-flow/SKILL.md · Interactive system flow tracing across CODE, API, AUTH, DATA, NETWORK layers with SQLite persistence and Mermaid…
v1.0.0 · audit A · 4,700 stars
authentication-patterns SKILL.md skill
zebbern/claude-code-guide · skills/authentication-patterns/SKILL.md · Authentication patterns: session vs JWT vs OAuth comparison, provider selection (NextAuth, Clerk, Supabase Auth)…
git:20260531.164971d · audit A · 4,700 stars
aws-penetration-testing SKILL.md skill
zebbern/claude-code-guide · skills/aws-penetration-testing/SKILL.md · This skill should be used when the user asks to "pentest AWS", "test AWS security", "enumerate IAM", "exploit cloud…
v1.1 · audit B · 4,700 stars
broken-authentication SKILL.md skill
zebbern/claude-code-guide · skills/broken-authentication/SKILL.md · This skill should be used when the user asks to "test for broken authentication vulnerabilities", "assess session…
v1.1 · audit A · 4,700 stars
burp-suite-testing SKILL.md skill
zebbern/claude-code-guide · skills/burp-suite-testing/SKILL.md · This skill should be used when the user asks to "intercept HTTP traffic", "modify web requests", "use Burp Suite for…
v1.1 · audit B · 4,700 stars
caching SKILL.md skill
zebbern/claude-code-guide · skills/caching/SKILL.md · Caching strategies — invalidation, TTL guidelines, cache keys, cache layers, and when not to cache. Use when…
git:20260531.164971d · audit A · 4,700 stars
chart-image SKILL.md skill
zebbern/claude-code-guide · skills/chart-image/SKILL.md · Generate publication-quality PNG chart images from data, supporting line, bar, area, candlestick, pie, and heatmap…
v2.5.1 · audit A · 4,700 stars
cloud-penetration-testing SKILL.md skill
zebbern/claude-code-guide · skills/cloud-penetration-testing/SKILL.md · This skill should be used when the user asks to "perform cloud penetration testing", "assess Azure or AWS or GCP…
v1.1 · audit C · 4,700 stars

Every file in zebbern/claude-code-guide

Browse by kind, by grade A, or by owner.