Skip to main content
skill CX Codex

w-tdd — Claude Code skill: TDD and installation

The w-tdd Claude Code skill guides implementation through red-green-refactor. It activates when a developer requests TDD or the repository requires it.

MIT 647 installs ★ 1 updated 2026-10-02

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

What w-tdd does

The skill starts with a test that fails for the requested behavior, adds the smallest implementation that passes, then refactors while keeping tests green. It runs the focused test file after each cycle, followed by the affected suite.

Testing follows the repository’s MDX testing guide and vitest-v5, or the skill for the project’s test stack. When behavior or commands change, it suggests running /w-docs. It does not commit unless asked.

What it helps with

  • write a failing test for new behavior
  • implement the smallest change that passes the test
  • refactor while keeping tests green
  • check changes through repeated TDD cycles

Example prompts for the agent

  • Implement this change with TDD: start with a failing test.
  • Use red-green-refactor for this feature, then run the affected tests.
  • Change this command with TDD and update the documentation.

How to install w-tdd

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-tdd -a claude-code

2Manually: put the files in place

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

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

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

Questions about w-tdd

How do I install w-tdd in Claude Code?

Run npx skills add blockmatic-icebox/basilic-skills --skill w-tdd -a claude-code. The skill file is at ~/.claude/skills/w-tdd/SKILL.md.

What does w-tdd do?

It structures implementation as a failing test, the smallest passing change, and a refactor. After each cycle, it runs the focused test file and then the affected suite.

When does w-tdd use TDD?

Only when requested by the user or required by the repository. It follows the project’s testing guide and does not commit unless asked.

Source text

SKILL.md · MIT
---
name: w-tdd
description: Implement a requested increment with red-green-refactor.
disable-model-invocation: true
---

Use TDD only when the user asked for it or the repository requires it. Follow the repo testing MDX and `vitest-v5` (or the stack's test skill). Do not commit unless asked.

1. Red: write a failing test for the desired behavior. Use real APIs where the repo tests do; mock only at documented boundaries.
2. Green: write the smallest implementation that passes that test.
3. Refactor: improve structure while tests stay green.
4. Repeat for the next increment. Run the focused test file each cycle, then the affected suite.
5. Docs: `/w-docs` if behavior or commands changed.

© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills

Similar skills

All skills for Testing and QA →

From the same set45

The whole set →
w-security w-security is a Claude Code skill that checks code changes or a repository tree against its security docs and existing checks. Run it to review a change for security defects. CX Codex +1 647installs w-review w-review — a skill for Claude Code checks changes for evidenced defects and risks. Run it on a diff, branch, PR, or working tree without asking it to edit code. CX Codex +1 647installs w-api-test The w-api-test Claude Code skill adds API tests that check public HTTP behavior through the project’s existing harness. It runs on request to test an API. CX Codex +1 647installs w-unit The w-unit skill for Claude Code adds unit tests for the current change using the repository’s testing conventions. It checks public APIs, error paths, and related regressions. CX Codex +1 647installs w-test w-test — a skill for Claude Code that executes project test commands and resolves failure causes step by step until the suite turns green. CX Codex +1 647installs w-yolo The w-yolo Claude Code skill fixes failing local checks on request. It reruns the failing command or a check for the changes, without publishing them. CX Codex +1 647installs w-lint The w-lint Claude Code skill runs project linters and applies small fixes. It requires an explicit invocation because automatic invocation is disabled. CX Codex +1 647installs w-vercel The w-vercel Claude Code skill examines Vercel build failures and fixes the local build. It handles failures on the current branch. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open