tdd-guide

Translate requirements into executable tests and coverage analyses for TypeScript, Python, and Java projects.

1|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/recallnet/polymarket-cross-sectional-momentum --skill tdd-guide-recallnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-guide
Source: https://github.com/recallnet/polymarket-cross-sectional-momentum/tree/main/.agents/skills/tdd-guide
Command: npx skills add https://github.com/recallnet/polymarket-cross-sectional-momentum --skill tdd-guide-recallnet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps development teams quickly translate requirements into executable tests, identify coverage gaps, and orchestrate TDD cycles to improve software quality.

Core Features & Use Cases

  • Test Generation: Convert user stories and specs into structured test stubs across multiple frameworks (Jest, Pytest, JUnit, Vitest, Mocha).
  • Coverage Analysis: Parse LCOV, JSON, and XML reports to identify gaps and priorities.
  • TDD Workflow Guidance: Provide RED-GREEN-REFACTOR steps, validation, and refactoring suggestions to keep tests green.

Quick Start

Provide a scenario with source code and framework, and run the skill to generate initial tests.

Frequently Asked Questions about tdd-guide

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

FAQPage Schema
How do I generate test stubs from user stories for Jest and Pytest projects?

To generate test stubs from user stories, provide your scenario and source code to translate requirements into structured tests across frameworks like Jest, Pytest, JUnit, Vitest, or Mocha. This allows you to quickly scaffold executable tests for multi-language projects.

What is the RED-GREEN-REFACTOR cycle in TDD workflows?

The RED-GREEN-REFACTOR cycle is a TDD workflow where you write a failing test, make it pass, and then improve the code. The skill provides TDD workflow guidance by validating these steps and offering actionable refactoring suggestions to keep tests green.

How do I identify coverage gaps using LCOV and XML reports?

To identify coverage gaps, the skill parses LCOV, JSON, and XML reports to analyze your test suite against an enforced 80% coverage threshold. This process highlights missing test areas and provides actionable recommendations to improve coverage.

Can I use this TDD workflow with both TypeScript and Python projects?

Yes, you can use this workflow with TypeScript, Python, and Java projects. It supports multi-language project environments by applying TDD guidance, coverage analyses, and test generation across their respective frameworks like Vitest, Pytest, and JUnit.

What's the best way to enforce a minimum test coverage threshold?

The best way to enforce a minimum test coverage threshold is to parse coverage reports and validate them against the 80% threshold enforced by this skill. It assesses your test suites and provides actionable recommendations to close any identified coverage gaps.

Why does my generated test suite fail to meet coverage requirements?

Your generated test suite may fail coverage requirements if the parsed LCOV, JSON, or XML reports indicate gaps below the enforced 80% coverage threshold. The skill analyzes these reports to provide actionable recommendations and refactoring cues to improve coverage.