How do I install the Tdd skill?

Run npx skillmds@latest add tomevault-io/tdd-16 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tdd?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tdd by tomevault-io — Agent Skill

Name: Tdd
Author: tomevault-io

Tdd

Test-Driven Development (TDD) skill for Red-Green-Refactor cycle. Use when implementing features with tests first, minimal code to pass, then refactor. Teammates execute TDD autonomously within their own context in Agent Teams. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

SKILL: Test-Driven Development (TDD)

Purpose: Execute TDD Red-Green-Refactor cycle for feature implementation Target: Coder teammates implementing features with test-first methodology in Agent Teams ⚠️ Teammates Only: This skill is for coder teammates in Agent Teams. Team Lead delegates via teammate spawn.

Quick Start

When to Use This Skill

Implement new feature with test coverage
Fix bug with regression tests
Refactor code with test safety net

Quick Reference

# Red: pytest tests/test_feature.py -k "SC-1"  # FAIL
# Green: [Implement feature]
# Refactor: [Refactor code]
# Verify: pytest  # ALL PASS

What This Skill Covers

In Scope

Red-Green-Refactor cycle execution
Test-first development methodology
Minimal implementation for Green phase

Out of Scope

Test framework selection → @.claude/skills/tdd/REFERENCE.md
Coverage thresholds → @.claude/skills/ralph-loop/SKILL.md
Code quality standards → @.claude/skills/vibe-coding/SKILL.md

Core Concepts

The TDD Cycle: Red-Green-Refactor

Phase 1: Red - Write Failing Test

def test_add_two_numbers():
    result = calculator.add(2, 3)
    assert result == 5

Run test → Confirm it FAILS (❌)

Phase 2: Green - Minimal Implementation

def add(a, b):
    return a + b  # Just enough to pass

Run test → Confirm it PASSES (✅)

Phase 3: Refactor - Improve Quality

def add(a: int, b: int) -> int:
    """Add two integers with type safety."""
    return a + b

Run ALL tests → Confirm ALL PASS (✅)

Why TDD Matters

Tests drive design: API designed from usage perspective
Regression safety: Refactor without fear
Living documentation: Tests show intended behavior
Fast feedback: Catch issues immediately

---name: tdd-16description: Test-Driven Development (TDD) skill for Red-Green-Refactor cycle. Use when implementing features with tests first, minimal code to pass, then refactor. Teammates execute TDD autonomously within their own context in Agent Teams. Use when this capability is needed.---# SKILL: Test-Driven Development (TDD)> **Purpose**: Execute TDD Red-Green-Refactor cycle for feature implementation> **Target**: Coder teammates implementing features with test-first methodology in Agent Teams> **⚠️ Teammates Only**: This skill is for coder teammates in Agent Teams. Team Lead delegates via teammate spawn.---## Quick Start### When to Use This Skill- Implement new feature with test coverage- Fix bug with regression tests- Refactor code with test safety net### Quick Reference```bash# Red: pytest tests/test_feature.py -k "SC-1" # FAIL# Green: [Implement feature]# Refactor: [Refactor code]# Verify: pytest # ALL PASS```## What This Skill Covers### In Scope- Red-Green-Refactor cycle execution- Test-first development methodology- Minimal implementation for Green phase### Out of Scope- Test framework selection → @.claude/skills/tdd/REFERENCE.md- Coverage thresholds → @.claude/skills/ralph-loop/SKILL.md- Code quality standards → @.claude/skills/vibe-coding/SKILL.md## Core Concepts### The TDD Cycle: Red-Green-Refactor**Phase 1: Red** - Write Failing Test```pythondef test_add_two_numbers(): result = calculator.add(2, 3) assert result == 5```Run test → Confirm it FAILS (❌)**Phase 2: Green** - Minimal Implementation```pythondef add(a, b): return a + b # Just enough to pass```Run test → Confirm it PASSES (✅)**Phase 3: Refactor** - Improve Quality```pythondef add(a: int, b: int) -> int: """Add two integers with type safety.""" return a + b```Run ALL tests → Confirm ALL PASS (✅)### Why TDD Matters- **Tests drive design**: API designed from usage perspective- **Regression safety**: Refactor without fear- **Living documentation**: Tests show intended behavior- **Fast feedback**: Catch issues immediately## Further Reading**Internal**: @.claude/skills/tdd/REFERENCE.md - Advanced TDD concepts, patterns, and examples | @.claude/skills/ralph-loop/SKILL.md - Autonomous completion loop | @.claude/skills/vibe-coding/SKILL.md - Code quality standards | @.claude/skills/tdd/REFERENCE.md - Test framework detection**External**: [Test-Driven Development by Kent Beck](https://www.amazon.com/Test-Driven-Development-Kent-Beck/dp/0321146530) | [Growing Object-Oriented Software, Guided by Tests](https://www.amazon.com/Growing-Object-Oriented-Software-Guided-Tests/dp/0321503627)---> Converted and distributed by [TomeVault](https://tomevault.io/claim/changoo89) — claim your Tome and manage your conversions.

Frequently asked questions

Tdd