Skip to main content
skill CX Codex

tdd-guide · borghei — Claude Code skill: TDD and installation

The tdd-guide Claude Code skill guides red-green-refactor cycles and works with test suites. It can draft tests from requirements and inspect coverage reports for gaps.

LicenseRef-MIT-Commons-Clause 143 installs ★ 1,183 updated 2026-11-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill tdd-guide -a claude-code
Open on GitHub

What tdd-guide does

The skill guides red-green-refactor steps, drafts tests from requirements, and reads LCOV, Istanbul JSON, or Cobertura XML coverage reports. It can also assess test quality and convert tests across Jest, Vitest, Pytest, JUnit, and other supported frameworks.

The package includes scripts/tdd.py, a CLI with coverage, generate, and quality commands. coverage reports files and lines below the target; it returns exit code 1 while gaps remain. Its default threshold is 80, and --threshold lets you set another value.

Generated stubs fail until you add a real assertion. To generate them, provide a framework and requirements or an API specification; coverage analysis takes a report file.

What it helps with

  • write a failing test for a new feature
  • draft tests from requirements or an API specification
  • find uncovered files and lines in a coverage report
  • assess test quality and flag test smells
  • convert tests between Jest, Pytest, JUnit, and Vitest

Example prompts for the agent

  • Generate pytest stubs from requirements.json with python scripts/tdd.py generate requirements.json --framework pytest.
  • Inspect coverage.lcov with a threshold of 80 using python scripts/tdd.py coverage coverage.lcov --threshold 80.
  • Assess tests/test_discount.py and return JSON with python scripts/tdd.py quality tests/test_discount.py --format json.

How to install tdd-guide

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill tdd-guide -a claude-code

2Manually: put the files in place

~/.claude/skills/tdd-guide/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tdd-guide/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tdd-guide

How do I install tdd-guide in Claude Code?

Run npx skills add borghei/Claude-Skills --skill tdd-guide -a claude-code. The skill file is at ~/.claude/skills/tdd-guide/SKILL.md.

What does tdd-guide do?

It guides red-green-refactor work, drafts test stubs from requirements, and examines coverage reports for gaps. It also scores test quality and supports test conversion across frameworks.

Which coverage report formats does tdd-guide accept?

Its coverage command reads LCOV, Istanbul JSON, and Cobertura XML. It reports uncovered lines and files below the chosen threshold.

Similar skills

All skills for Testing and QA →

tdd-guide by other authors comes first.

tdd-guide Alireza Rezvani tdd-guide guides test-driven development, builds unit tests, and detects test coverage gaps. It supports Jest, Pytest, JUnit, and Vitest projects. CX Codex +1 1,017installs tdd-guide alirezarezvani tdd-guide is a Claude Code skill that generates tests from requirements or code, reviews coverage, and guides Red-Green-Refactor to find untested scenarios. CX Codex +1 ★ 907repo stars tdd glebis tdd runs test-driven development cycles with strict context separation across subagents. Useful for writing clean features and reproducing bugs. CX Codex +1 262installs tdd-orchestrator davila7 tdd-orchestrator is a Claude Code skill that orchestrates test-driven development through red-green-refactor cycles. It coordinates multi-agent testing workflows and verifies test-first compliance. CX Codex +1 51installs TDD Red Phase - Write Failing Tests First official github The TDD Red Phase - Write Failing Tests First subagent pulls GitHub issue context from branch names and creates failing tests for acceptance criteria before code is written. It enforces the red stage of TDD. CX Codex +1 ★ 41,430repo stars tdd-red Seth Hobson tdd-red — a slash command that writes only tests which must fail, and leaves production code alone. The first step of TDD, when behavior needs pinning down before implementation. CX Codex +1 ★ 42,780repo stars test-analysis-extensions dotnet test-analysis-extensions is a Claude Code skill with per-language lookup tables for test analysis. The agent reads the file matching the project's stack. CX Codex +1 4,200installs python-tdd-with-uv spencerpauly python-tdd-with-uv — a skill for Claude Code, Codex, Cursor and other agents that enforces test-first Python development using uv for dependency management. Every cycle: one failing test, the minimum code to pass it, then refactor. CX Codex +1 449installs

From the same set120

The whole set →
skill-security-auditor skill-security-auditor — a skill for Claude Code, Codex, Cursor, Copilot, Gemini CLI and OpenCode that scans agent skills before install. It detects prompt injection, dangerous code, credential harvesting and supply chain risks. CX Codex +1 146installs create-prd create-prd builds a product requirements doc in eight parts, from problem statement to P0/P1/P2 scope and release plan. Useful when a new feature needs one shared spec. CX Codex +1 146installs senior-computer-vision senior-computer-vision is a Claude Code skill for designing computer vision pipelines with object detection and segmentation. CX Codex +1 145installs app-store-optimization app-store-optimization is a Claude Code skill that researches store keywords, refines app metadata, and analyzes reviews for Apple App Store and Google Play listings. CX Codex +1 144installs landing-page-generator The landing-page-generator Claude Code skill plans and builds landing pages around one conversion goal. It also supports campaign and lead-capture pages. CX Codex +1 142installs content-strategy content-strategy guides content planning by structuring topic clusters, defining content pillars, and auditing published material. CX Codex +1 140installs atlassian-templates atlassian-templates — a skill to build, validate, and manage Jira and Confluence templates across your organization. CX Codex +1 140installs rag-architect rag-architect — a skill for Claude Code and Cursor designs RAG pipelines and tunes chunking configurations. It benchmarks retrieval quality using Recall@K and MRR on real queries. CX Codex +1 137installs

Project sponsors

Companies that keep this analytics open