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
npx skills add blockmatic-icebox/basilic-skills --skill w-tdd -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/w-tdd/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-tdd/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-tdd -a codex2Manually: put the files in place
.agents/skills/w-tdd/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-tdd -a cursor2Manually: put the files in place
.cursor/skills/w-tdd/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-tdd2Manually: put the files in place
.github/skills/w-tdd/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-tdd -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-tddManually: put the files in place
.devin/skills/w-tdd/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-tdd -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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