Superpowers Test Driven Development
christopherarter/superpowers-reasonix
Writing or fixing any code?. An agent skill from christopherarter/superpowers-reasonix.
Test-first development route for TDD, writing failing tests first, RED - GREEN - REFACTOR, and behavior-changing feature/bug/refactor work.
Install TDD Guide
$ npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install foryourhealth111-pixel/Vibe-Skills tdd-guide --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/foryourhealth111-pixel/Vibe-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bundled/skills/tdd-guide .claude/skills/tdd-guide && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "tdd-guide" agent skill from https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/main/bundled/skills/tdd-guide into .claude/skills/tdd-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd-guide", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/main/bundled/skills/tdd-guideType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install foryourhealth111-pixel/Vibe-Skills tdd-guide --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/foryourhealth111-pixel/Vibe-Skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/bundled/skills/tdd-guide .agents/skills/tdd-guide && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tdd-guide" agent skill from https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/main/bundled/skills/tdd-guide into .agents/skills/tdd-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd-guide", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install foryourhealth111-pixel/Vibe-Skills tdd-guide --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/foryourhealth111-pixel/Vibe-Skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/bundled/skills/tdd-guide .cursor/skills/tdd-guide && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tdd-guide" agent skill from https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/main/bundled/skills/tdd-guide into .cursor/skills/tdd-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd-guide", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/foryourhealth111-pixel/Vibe-Skills.git --path bundled/skills/tdd-guide--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install foryourhealth111-pixel/Vibe-Skills tdd-guide --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/foryourhealth111-pixel/Vibe-Skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/bundled/skills/tdd-guide .gemini/skills/tdd-guide && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tdd-guide" agent skill from https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/main/bundled/skills/tdd-guide into .gemini/skills/tdd-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd-guide", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install foryourhealth111-pixel/Vibe-Skills tdd-guideInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/foryourhealth111-pixel/Vibe-Skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/bundled/skills/tdd-guide .github/skills/tdd-guide && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tdd-guide" agent skill from https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/main/bundled/skills/tdd-guide into .github/skills/tdd-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd-guide", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install foryourhealth111-pixel/Vibe-Skills tdd-guide --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/foryourhealth111-pixel/Vibe-Skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/bundled/skills/tdd-guide .opencode/skills/tdd-guide && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tdd-guide" agent skill from https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/main/bundled/skills/tdd-guide into .opencode/skills/tdd-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd-guide", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
tdd-guide- GitHub stars
- 3.6k
- Token cost
- ~455 tokens
- SKILL.md length
- 199 words
- Files
- 1
- Skills in repo
- 81
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Test-first development route for TDD, writing failing tests first, RED - GREEN - REFACTOR, and behavior-changing feature/bug/refactor work.
- Already-failing test root-cause debugging
- SKILL.md covers Routing Boundary, Core Rule, Workflow and Minimum Test Set, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Test-report packaging
What it does
TDD Guide is an agent skill from foryourhealth111-pixel/Vibe-Skills. Test-first development route for TDD, writing failing tests first, RED - GREEN - REFACTOR, and behavior-changing feature/bug/refactor work. Do not use for already-failing test root-cause debugging, test-report packaging, or final completion evidence.
Its SKILL.md is about 460 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Testing & QA, covering Test-driven development and Failing and flaky tests. The repository describes itself as: Intelligent Skill routing and workflow orchestration for AI agents — +21.12 pp reward, −29.6% tokens on SkillsBench with DeepSeekV4Flash-VE. The licence is Apache-2.0.
When your agent uses it
- Already-failing test root-cause debugging
- Test-report packaging
- Final completion evidence
Example prompts
- “/tdd-guide”
What it can do on your machine
Read from SKILL.md and the folder at commit ddcaa2a. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
TDD Guide loads about 455 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 199 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from foryourhealth111-pixel/Vibe-Skills at commit ddcaa2a, republished under its Apache-2.0 licence (© foryourhealth111-pixel). 199 words, ~455 tokens.
Download SKILL.mdSave it as
.claude/skills/tdd-guide/SKILL.md (or your agent's skills folder).- name
- tdd-guide
- description
- Test-first development route for TDD, writing failing tests first, RED -> GREEN -> REFACTOR, and behavior-changing feature/bug/refactor work. Do not use for already-failing test root-cause debugging, test-report packaging, or final completion evidence.
tdd-guide (Codex Compatibility)
Use this skill for all feature work, bug fixes, and refactors that change behavior.
Routing Boundary
Use this skill when the user wants to build or change behavior through tests:
- TDD / test-driven development
- write failing tests first
- test-first implementation
- RED -> GREEN -> REFACTOR
Do not use it when tests are already failing and the user wants root cause; route that to systematic-debugging. Do not use it when the user only wants a test/coverage report; route that to generating-test-reports.
Core Rule
No production code before a failing test.
Workflow
- RED
- Write one failing test for one behavior.
- Confirm the failure is expected.
- GREEN
- Implement the minimal code to pass.
- Re-run tests and keep scope narrow.
- REFACTOR
- Improve structure/naming without changing behavior.
- Keep all tests green.
- COVERAGE
- Verify coverage target (recommended >=80% for lines/functions/branches).
- Add missing tests for edge/error paths.
Minimum Test Set
- Unit: public functions and core logic.
- Integration: API/data/service boundaries.
- E2E: critical user path only when relevant.
Required Edge Cases
- Null/undefined input
- Empty values
- Invalid types
- Boundary values
- Error paths (network/DB/file)
- Concurrency-sensitive behavior
Vibe Integration
- Primary coding skill in M-grade flow.
- Compatible fallback target for
everything-claude-code:tdd-guide. - For richer TDD patterns, combine with
test-driven-development.
© foryourhealth111-pixel, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in bundled/skills/tdd-guide of foryourhealth111-pixel/Vibe-Skills.
Open the folder on GitHubat commit ddcaa2a
Compare with similar skills
TDD Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| TDD Guide this skillforyourhealth111-pixel/Vibe-Skills | 3.6k | — | ~455 | Automated safety check: Pass | Apache-2.0 | |
| Superpowers Test Driven Developmentchristopherarter/superpowers-reasonix | 102 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Openspec Plus TDDelastic/terraform-provider-elasticstack | 210 | 1 repos | ~4.7k | Automated safety check: Pass | Apache-2.0 | |
| Fix BugMelbourneDeveloper/dart_node | 113 | 1 repos | ~709 | Automated safety check: Notes | None | |
| Evanflow Debugevanklem/evanflow | 418 | — | ~760 | Automated safety check: Pass | Custom licence | |
| TDDcodeaholicguy/ai-devkit | 1.6k | — | ~838 | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Openspec Plus TDD
elastic/terraform-provider-elasticstack
MANDATORY skill that activates whenever code is written to implement an OpenSpec change task.
Fix Bug
MelbourneDeveloper/dart_node
Fix a bug using test-driven development. An agent skill from MelbourneDeveloper/dart_node.
Evanflow Debug
evanklem/evanflow
Root-cause discipline for bugs, test failures, and unexpected behavior.
TDD
codeaholicguy/ai-devkit
AI DevKit · Test-driven development — write a failing test before writing production code.
TDD Workflows TDD Green
aiskillstore/marketplace
Implement the minimal code needed to make failing tests pass in the TDD green phase.
More from foryourhealth111-pixel/Vibe-Skills
All 81 skills in this repoMarket Research Reports
foryourhealth111-pixel/Vibe-Skills
Produces long consulting-style market research and industry reports covering market sizing, competitive landscape, market entry and investment theses.
Academic Venue Templates
foryourhealth111-pixel/Vibe-Skills
Supplies venue-specific LaTeX templates and formatting rules for journals, conferences and posters, and checks a manuscript against page limits and submission requirements.
Digital Brain
foryourhealth111-pixel/Vibe-Skills
This skill should be used when the user asks to "write a post", "check my voice", "look up contact", "prepare for meeting", "weekly review", "track goals", or mentions personal brand, content…
Smart File Writer
foryourhealth111-pixel/Vibe-Skills
Diagnoses why a file write failed (permissions, disk space, path length, locks, read-only mounts) before retrying, instead of repeating the same call blindly.
Automated Video Studio
foryourhealth111-pixel/Vibe-Skills
Turns footage, audio and a storyboard plan into a finished short video with FFmpeg jump-cuts, subtitle burn-in and a final polish pass.
Citation Management
foryourhealth111-pixel/Vibe-Skills
Turns DOIs, PMIDs and arXiv IDs into clean BibTeX, searches Google Scholar and PubMed, and checks and deduplicates a reference list.
Related
Categories
Questions about TDD Guide
What does TDD Guide do?
Test-first development route for TDD, writing failing tests first, RED - GREEN - REFACTOR, and behavior-changing feature/bug/refactor work. TDD Guide is an agent skill from foryourhealth111-pixel/Vibe-Skills. Test-first development route for TDD, writing failing tests first, RED - GREEN - REFACTOR, and behavior-changing feature/bug/refactor work.
When should I use TDD Guide?
TDD Guide fits situations like: already-failing test root-cause debugging; test-report packaging; final completion evidence.
How do I install TDD Guide in Claude Code?
Run `npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a claude-code`. Or copy the skill folder (bundled/skills/tdd-guide in foryourhealth111-pixel/Vibe-Skills) into .claude/skills/tdd-guide in your project. Claude Code loads it when a task matches its description.
How do I install TDD Guide in Codex?
Run `npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a codex`. Or copy the skill folder (bundled/skills/tdd-guide in foryourhealth111-pixel/Vibe-Skills) into .agents/skills/tdd-guide in your project. Codex loads it when a task matches its description.
Can I use TDD Guide in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add foryourhealth111-pixel/Vibe-Skills --skill tdd-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tdd-guide, .gemini/skills/tdd-guide, .github/skills/tdd-guide and .opencode/skills/tdd-guide in your project.
What does TDD Guide need to run?
SKILL.md names no scripts, command-line tools or credentials: TDD Guide is instructions for the agent only.
Does TDD Guide access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is TDD Guide safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does TDD Guide use?
TDD Guide is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does TDD Guide use?
About 455 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to TDD Guide?
Skills that share tags, products or a category with TDD Guide: Superpowers Test Driven Development (christopherarter/superpowers-reasonix, 102 stars), Openspec Plus TDD (elastic/terraform-provider-elasticstack, 210 stars), Fix Bug (MelbourneDeveloper/dart_node, 113 stars) and Evanflow Debug (evanklem/evanflow, 418 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains TDD Guide?
foryourhealth111-pixel (a GitHub user) maintains it in foryourhealth111-pixel/Vibe-Skills, which has 3,627 GitHub stars. The repository holds 81 skills in this directory. The repository was last updated on August 31, 2026.
Source: foryourhealth111-pixel/Vibe-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.