Does this skill help with code refactoring?

Yes, the 'Refactor' phase is a core part of the workflow. After the tests turn green, the skill focuses on improving code structure and clarity while ensuring tests remain passing.

What if my project currently has no tests?

The skill includes a policy to first add a minimal test harness and a failing test case before proceeding with any functional code changes.

How does the skill handle type errors?

The skill follows a strict typecheck policy where types must always pass. It will fix or revert changes if they introduce new type errors, rather than ignoring pre-existing ones.

Can I use this skill with Bun's native test runner?

No, this skill is explicitly configured for Vitest. It contains non-negotiable instructions to avoid bun:test imports and APIs to ensure compatibility with the project's testing infrastructure.

TDD Red-Green-Refactor

Name: TDD Red-Green-Refactor
Author: skillrecordings

byskillrecordings

0•

Security & Testing

Enforces a strict Test-Driven Development workflow using Vitest to ensure every code change is validated by failing tests first.

The TDD Red-Green-Refactor skill optimizes Claude Code for high-integrity software development by mandating a strict test-first methodology. It guides the AI agent to identify minimal observable behaviors, write failing Vitest cases, implement the smallest possible fix to achieve a 'green' state, and perform safe refactoring. This skill is particularly critical for maintaining complex codebases where regressions must be avoided, specifically enforcing the use of Vitest over other runners like bun:test to maintain environment consistency and reliability.

Key Features

01Native Vitest integration with specific mocking patterns

02Strict Red-Green-Refactor workflow enforcement

03Comprehensive test reporting including command outputs and results

04Automated failing test generation for new requirements

050 GitHub stars

06Minimalist code implementation strategy to reduce technical debt

Use Cases

01Debugging complex issues by reproducing them with a failing test first

02Implementing new business logic with guaranteed test coverage

03Refactoring legacy code structures while ensuring behavioral parity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add skillrecordings/support tdd-red-green-refactor

For use in Claude.ai and ChatGPT

Download Skill