Agent skill

TDD

by av in av/mi

Add new behavior test-first (write failing test → make it pass → refactor).

No licenceAuto-check passedTesting & QA

Install TDD

skills CLI
$ npx skills add av/mi --skill tdd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install av/mi tdd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/av/mi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tdd .claude/skills/tdd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tdd
GitHub stars
102
Token cost
~972 tokens
SKILL.md length
538 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
None found

At a glance

Add new behavior test-first (write failing test → make it pass → refactor).

  • Works in 5 steps: Red — write one failing test → Red — confirm it fails for the right… → Green — minimum code to pass → …
  • Asked to add a test for
  • Calls cargo, go and pytest
  • Implement X with tests

What it does

TDD is an agent skill from av/mi. Add new behavior test-first (write failing test → make it pass → refactor). Use when asked to "add a test for", "implement X with tests", or extending a codebase that already has a test suite.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Test-driven development, Failing and flaky tests and Test generation. The repository describes itself as: self-extending sandboxed agentic harness. a loop, two tools and an llm.

When your agent uses it

  • Asked to add a test for
  • Implement X with tests
  • Extending a codebase that already has a test suite

Example prompts

  • “add a test for”
  • “implement X with tests”
  • “/tdd”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Red — write one failing test
  2. Red — confirm it fails for the right reason
  3. Green — minimum code to pass
  4. Green — run the relevant subset
  5. Refactor

What it can do on your machine

Read from SKILL.md and the folder at commit 2bf50c9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo
    • go
    • pytest
    • vitest
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

TDD loads about 972 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 538 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~972

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 538 words (~972 tokens).

“First, confirm a test harness exists (pytest, jest/vitest, cargo test, go test, rspec, etc.) and that the existing suite runs green. If there is no harness, stop and tell the user — do not scaffold one without being asked.”

— opening of SKILL.md by av
name
tdd

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/tdd of av/mi.

Open the folder on GitHubat commit 2bf50c9

Compare with similar skills

TDD next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

TDD compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
TDD this skillav/mi102—~972Automated safety check: PassNone
Swig Testswig/swig6.3k—~2.3kAutomated safety check: PassCustom licence
Wioworkersio/skills180—~5.8kAutomated safety check: PassMIT
Offloadimbue-ai/offload125—~3.1kAutomated safety check: PassMIT
Designing TestsCloudAI-X/opencode-workflow275—~2.9kAutomated safety check: PassMIT
TDD Guidealirezarezvani/claude-code-skill-factory8791 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • Swig Test

    swig/swig

    Run SWIG test suite for specific languages. An agent skill from swig/swig.

    6.3k GitHub stars~2.3k tokensUpdated today
    Testing & QAAuto-check passed
  • Wio

    workersio/skills

    Testing workflow skill for finding high-value test candidates, writing focused tests, generating realistic workloads, reviewing test value, and diagnosing test-suite health.

    180 GitHub stars~5.8k tokensUpdated 2 mo ago
    Testing & QAAuto-check passed
  • Offload

    imbue-ai/offload

    Activate when you see offload.toml in a repo, offload referenced in build targets (justfile, Makefile, scripts), or when you need to run a large test suite in parallel.

    125 GitHub stars~3.1k tokensUpdated 11 days ago
    Testing & QAAuto-check passed
  • Designing Tests

    CloudAI-X/opencode-workflow

    Guides test strategy, TDD/BDD approaches, test coverage planning, and testing best practices.

    275 GitHub stars~2.9k tokensUpdated 9 mo ago
    Testing & QAAuto-check passed
  • TDD Guide

    alirezarezvani/claude-code-skill-factory

    Comprehensive Test Driven Development guide for engineering subagents with multi-framework support, coverage analysis, and intelligent test generation

    879 GitHub starsUsed in 1 repo~2.7k tokens
    Testing & QAAuto-check passed
  • Superpowers Test Driven Development

    christopherarter/superpowers-reasonix

    Writing or fixing any code?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~1.9k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Writes plain-English integration test specs with verifiable steps and expectations, then runs each one through a subagent that reports pass or fail with logs.

    102 GitHub stars~908 tokensUpdated 11 days ago
    Auto-check passed
  • Anneal

    av/mi

    A skill your agent uses when the user wants to systematically fix AI code slop — duplicated logic, over-engineering, silent error swallowing, convention drift, cargo-cult patterns, and other…

    102 GitHub stars~3.8k tokensUpdated 11 days ago
    Auto-check passed
  • Scans a codebase to tag every fact as draft, spec or implemented based on what the code actually shows, adding missing facts and fixing or removing wrong ones.

    102 GitHub stars~2.8k tokensUpdated 11 days ago
    Auto-check passed
  • Implements every @spec fact from a project's fact sheet in code, tags each one @implemented once done, and reports exactly what is left if it cannot finish.

    102 GitHub stars~1.3k tokensUpdated 11 days ago
    Auto-check passed
  • Works with you to turn draft behavioral facts into precise, implementable spec facts, resolving vague labels, gaps and contradictions one at a time through discussion.

    102 GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check passed
  • Ideate

    av/mi

    Timeboxed ideation on a topic using propose-and-critique subagent pairs.

    102 GitHub stars~2.8k tokensUpdated 11 days ago
    Auto-check passed

Categories

Questions about TDD

What does TDD do?

Add new behavior test-first (write failing test → make it pass → refactor). TDD is an agent skill from av/mi. Add new behavior test-first (write failing test → make it pass → refactor).

When should I use TDD?

TDD fits situations like: asked to add a test for; implement X with tests; extending a codebase that already has a test suite.

How do I install TDD in Claude Code?

Run `npx skills add av/mi --skill tdd -a claude-code`. Or copy the skill folder (skills/tdd in av/mi) into .claude/skills/tdd in your project. Claude Code loads it when a task matches its description.

How do I install TDD in Codex?

Run `npx skills add av/mi --skill tdd -a codex`. Or copy the skill folder (skills/tdd in av/mi) into .agents/skills/tdd in your project. Codex loads it when a task matches its description.

Can I use TDD in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add av/mi --skill tdd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tdd, .gemini/skills/tdd, .github/skills/tdd and .opencode/skills/tdd in your project.

What does TDD need to run?

Going by SKILL.md and its folder, TDD needs the command-line tools its instructions call (cargo, go, pytest, vitest and python3). Our summary lists: Python 3.

Does TDD access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is TDD safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does TDD use?

No licence was found for TDD or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does TDD use?

About 972 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to TDD?

Skills that share tags, products or a category with TDD: Swig Test (swig/swig, 6.3k stars), Wio (workersio/skills, 180 stars), Offload (imbue-ai/offload, 125 stars) and Designing Tests (CloudAI-X/opencode-workflow, 275 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains TDD?

av (a GitHub user) maintains it in av/mi, which has 102 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on September 26, 2026.

Source: av/mi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.