tdd SKILL.md skillA

tdd from jkitchin/knowhow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jkitchin/knowhow/tdd@git:20260307.3e74b2f

Pins git:20260307.3e74b2f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jkitchin/knowhow
Path
skills/development/tdd/SKILL.md
Versions recorded
2
Latest version
git:20260307.3e74b2f, committed Mar 7, 2026
First version recorded
Nov 6, 2025
Size
12,795 bytes
Repository stars
42
License
MIT

Test-Driven Development facilitation using the red-green-refactor cycle. Guides users through writing tests first, implementing minimal code to pass, and refactoring for quality. Use when users want to practice TDD, need help writing tests before code, are developing new features test-first, or want guidance on test structure and implementation. Triggers include 'use TDD,' 'test-driven development,' 'write tests first,' 'red-green-refactor,' or requests to develop functionality with tests.

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 (TDD) Skill

Guide users through disciplined test-first development using the red-green-refactor cycle.

## Core TDD Workflow

**RED → GREEN → REFACTOR → REPEAT**

### RED: Write a Failing Test
1. Identify next small behavior to implement
2. Write test that specifies that behavior
3. Run test to verify it **fails for the right reason**
4. If test passes unexpectedly, test is wrong

### GREEN: Make It Pass
1. Write **minimal** code to make test pass
2. Don't worry about perfection yet
3. Simplest solution that works
4. Run test to verify it passes

### REFACTOR: Improve the Code
1. Improve code quality while keeping tests green
2. Remove duplication
3. Improve names and structure
4. Run tests after each change to ensure still passing

### REPEAT
1. Commit when tests are green
2. Identify next behavior
3. Start cycle again with new test

## TDD Discipline

**Critical rules to follow:**

### Test First (RED Phase)
- **Always write test before implementation**
- Resist urge to write code first
- Test defines what "done" means
- See test fail before making it pass

### Minimal Implementation (GREEN Phase)
- **Write simplest code to pass**
- Don't over-engineer
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jkitchin/knowhow/tdd@sha256:cf09b3deb93916d7

The line at the top of this page pins the label git:20260307.3e74b2f, 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_yt3252wmgjnvz4qs.svg)](https://markdownregistry.com/a/art_yt3252wmgjnvz4qs)

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

Versions

The registry has recorded 2 versions of this file, between Nov 6, 2025 and Mar 7, 2026, about one every 121 days.

versioncommittedcommitsizeaudit
git:20260307.3e74b2f latest2026-03-07 3e74b2f 12,795 BA view · diff
git:20251106.c9f1f5d2025-11-06 c9f1f5d 12,793 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 (12795 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

jkitchin/knowhow · 42 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yt3252wmgjnvz4qs
GET https://markdownregistry.com/api/v1/resolve?ref=jkitchin/knowhow/tdd
GET https://markdownregistry.com/api/v1/blob/cf09b3deb93916d74e412d3bced36fc67514ecb6299650c6865be38be3851375

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 jkitchin/knowhow

CLAUDE.md CLAUDE.md file
jkitchin/knowhow · CLAUDE.md
git:20261026.5e9a3fa · audit A · 42 stars
phd-qualifier SKILL.md skill
jkitchin/knowhow · skills/academic/phd-qualifier/SKILL.md · Expert evaluation of Chemical Engineering PhD qualifying exams - review written reports, presentations, and prepare…
git:20260307.3e74b2f · audit A · 42 stars
citation-verifier SKILL.md skill
jkitchin/knowhow · skills/citation-verifier/SKILL.md · Verify citations and references in scientific documents to detect hallucinated or invalid sources. Extracts DOIs, URLs…
git:20260130.a88fc7e · audit A · 42 stars
scientific-writing SKILL.md skill
jkitchin/knowhow · skills/communication/scientific-writing/SKILL.md · Comprehensive scientific writing guidance for research papers, grants, and technical documentation. Covers paper…
git:20260307.3e74b2f · audit A · 42 stars
brainstorming SKILL.md skill
jkitchin/knowhow · skills/creative/brainstorming/SKILL.md · Structured brainstorming and ideation facilitation using proven creativity techniques. Use when users want to generate…
git:20260307.3e74b2f · audit A · 42 stars
elevenlabs SKILL.md skill
jkitchin/knowhow · skills/creative/elevenlabs/SKILL.md · AI-powered audio generation using ElevenLabs API - text-to-speech with lifelike voices, sound effects generation, and…
git:20251129.acd8950 · audit A · 42 stars
image-generation SKILL.md skill
jkitchin/knowhow · skills/creative/image-generation/SKILL.md · AI-powered image generation and editing using Google Gemini, Google Imagen, and OpenAI models. Generate images from…
git:20260307.3e74b2f · audit A · 42 stars
presentations SKILL.md skill
jkitchin/knowhow · skills/creative/presentations/SKILL.md · Create slide presentations in multiple formats: Marp (Markdown, default), Beamer (LaTeX), Jupyter Notebook slides, and…
git:20260227.5900c1a · audit A · 42 stars
video-storytelling SKILL.md skill
jkitchin/knowhow · skills/creative/video-storytelling/SKILL.md · Create coherent video story sequences with AI-generated images and narrated audio. Combines image-generation and…
git:20251129.ac2b86d · audit A · 42 stars
code-reviewer SKILL.md skill
jkitchin/knowhow · skills/development/code-reviewer/SKILL.md · Comprehensive code review and analysis for software quality assurance. Use when Claude needs to review code in any…
git:20260307.3e74b2f · audit A · 42 stars
ralph-wiggum SKILL.md skill
jkitchin/knowhow · skills/development/ralph-wiggum/SKILL.md · Autonomous AI coding loop for unattended development - lets Claude work continuously on tasks while you sleep, with…
git:20261026.5e9a3fa · audit B · 42 stars
version-control SKILL.md skill
jkitchin/knowhow · skills/development/version-control/SKILL.md · Expert guidance for Git version control, trunk-based development workflows, and GitHub best practices. Emphasizes…
git:20260307.3e74b2f · audit A · 42 stars

Every file in jkitchin/knowhow

Other files named tdd

tdd SKILL.md skill
yeachan-heo/oh-my-claudecode · skills/tdd/SKILL.md · Test-first at pre-agreed seams — one test, one implementation, tracer-bullet red/green; independent expected values…
git:20261009.7b270a4 · audit A · 40,492 stars
tdd SKILL.md skill
alirezarezvani/claude-skills · .gemini/skills/tdd/SKILL.md
git:20260309.8902ba7 · audit C · 29,054 stars
tdd SKILL.md skill
cursor/plugins · pstack/skills/tdd/SKILL.md · Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious…
git:20260923.b0b9c7a · audit A · 15,125 stars
tdd SKILL.md skill
cursor/plugins · harness/pstack/claude-code/skills/tdd/SKILL.md · Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious…
git:20261016.182f2ce · audit A · 15,125 stars
tdd SKILL.md skill
vinvcn/mattpocock-skills-zh-cn · skills/engineering/tdd/SKILL.md · 测试驱动开发。适用于用户想用先写测试的方式构建功能或修复缺陷、提到 “red-green-refactor”,或需要集成测试时。
git:20261028.c48fd4a · audit A · 5,526 stars
tdd SKILL.md skill
nightly-labs/openbot · marketplace/production-catalog/bundles/pstack/skills/tdd/SKILL.md · Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious…
git:20261013.9e6954c · audit A · 5,267 stars
tdd SKILL.md skill
michael-denyer/pstack-claude · plugins/pstack/skills/tdd/SKILL.md · Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious…
git:20260923.4a3ef20 · audit A · 3,776 stars
tdd SKILL.md skill
wesammustafa/claude-code-everything-you-need-to-know · examples/intermediate/01-first-skill/dot-claude/skills/tdd/SKILL.md · TODO
git:20261026.676831f · audit A · 3,518 stars

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