tdd-coach

Generate executable tests and guide red-green-refactor cycles across frameworks.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/philmcneely/tdd-coach-public --skill tdd-coach-philmcneely
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-coach
Source: https://github.com/philmcneely/tdd-coach-public/tree/main
Command: npx skills add https://github.com/philmcneely/tdd-coach-public --skill tdd-coach-philmcneely

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps engineering teams adopt test-driven development by turning requirements into executable tests and guiding red-green-refactor cycles, improving test quality and confidence.

Core Features & Use Cases

  • Generate executable tests from source code, acceptance criteria, or Jira-like tickets across multiple languages and frameworks.
  • Analyze coverage gaps, provide actionable recommendations, and help teams elevate their testing discipline.
  • Guide through Red-Green-Refactor workflows, score test quality, and suggest targeted refactoring opportunities.

Quick Start

Provide a concise scenario and let the skill generate a full executable test suite and guided TDD cycle.

Frequently Asked Questions about tdd-coach

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate executable tests from acceptance criteria or source code?

You can generate executable tests by providing source code, acceptance criteria, or Jira-like tickets to the TDD coach, which auto-detects your language and framework to produce a full test suite.

Does this TDD guidance tool support my Pytest or Jest testing framework?

Yes, the TDD coach auto-detects and supports multiple frameworks including Jest, Vitest, Mocha, Pytest, JUnit 4/5, Spring Boot, and Playwright for generating and running tests.

What is the red-green-refactor cycle and how do I apply it to my codebase?

The red-green-refactor cycle is a test-driven development workflow where you write failing tests, make them pass, and then improve the code, guided automatically through structured testing iterations.

How do I analyze test coverage gaps and score test quality?

You can analyze test coverage gaps and score test quality by loading your test context, which provides actionable recommendations and targeted refactoring opportunities to improve testing discipline.

Can I use this for characterization tests when refactoring legacy code?

Yes, the tool provides characterization workflows designed to help teams understand and lock in existing behavior, making it highly effective for refactoring legacy code safely.