Agent skill · software engineering · borghei
tdd-guide
Guide red-green-refactor TDD with test generation, coverage-gap analysis, and multi- framework support. Use when writing tests first, analyzing coverage, generating test stubs, or converting tests between Jest, Pytest, JUnit, and Vitest.
Why this skill is useful
Adds multi-framework test generation scripts and coverage analysis tools that the AI wouldn't reliably generate on its own.
What it needs
Requires jest, junit, mocha, pytest, vitest installed locally. About 3k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
TDD Guide The agent guides red-green-refactor TDD workflows, generates framework-specific test stubs from requirements, parses coverage reports to identify prioritized gaps, and calculates test quality metrics including smell detection and assertion density. Supports Jest, Pytest, JUnit, Vitest, and Mocha. Core Capabilities Red-green-refactor guidance — phase validation (RED/GREEN/REFACTOR), cycle tracking, refactoring suggestions Test generation — produce test cases and framework-specific stubs from user stories, acceptance criteria, and API specs Coverage gap analysis — parse LCOV/JSON/XML reports, identify files below threshold, prioritize P0/P1/P2 Test quality metrics — cyclomatic/cognitive complexity, assertion density, isolation, naming, and test smell detection Multi-framework support — convert tests and generate fixtures/mocks across Jest, Vitest, Pytest, JUnit, TestNG, Mocha, Jasmine When to Use Writing a failing test first for a new feature (test-driven development) Analyzing coverage reports to find and prioritize gaps Generating test stubs from requirements or API specs Converting tests between frameworks or scaffolding fixtures/mocks Assessing test quality and detecting smells before merge Clarify First Before generating tests or analyzing coverage, confirm these inputs. If any is unknown or vague, ASK — do not assume: [ ] Framework & language — Jest / Vitest / Pytest / JUnit / Mocha (changes the generated stubs and any conversion) [ ] Task — generate from requirements / analyze coverage / guide a red-green-refactor cycle / convert tests (selects the tool) [ ] Source input — the user story / acceptance criteria, or the coverage report (LCOV/JSON/XML) to parse (the script's input) Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/tdd-guide