Test Guidelines
getsentry/sentry-dart
Enforce Sentry Dart/Flutter SDK test conventions for naming, structure, and fixtures.
Fixes a bug with a failing regression test first when a cheap, focused test path exists, and falls back to the closest practical check when it does not.
Install TDD Bug Fix
$ npx skills add cursor/plugins --skill tdd -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cursor/plugins tdd --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/cursor/plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pstack/skills/tdd .claude/skills/tdd && 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" agent skill from https://github.com/cursor/plugins/tree/main/pstack/skills/tdd into .claude/skills/tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd", 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/cursor/plugins/tree/main/pstack/skills/tddType 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 cursor/plugins --skill tdd -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cursor/plugins tdd --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cursor/plugins.git skills-src && mkdir -p .agents/skills && cp -r skills-src/pstack/skills/tdd .agents/skills/tdd && 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" agent skill from https://github.com/cursor/plugins/tree/main/pstack/skills/tdd into .agents/skills/tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd", 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 cursor/plugins --skill tdd -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cursor/plugins tdd --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cursor/plugins.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/pstack/skills/tdd .cursor/skills/tdd && 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" agent skill from https://github.com/cursor/plugins/tree/main/pstack/skills/tdd into .cursor/skills/tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd", 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/cursor/plugins.git --path pstack/skills/tdd--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 cursor/plugins --skill tdd -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cursor/plugins tdd --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cursor/plugins.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/pstack/skills/tdd .gemini/skills/tdd && 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" agent skill from https://github.com/cursor/plugins/tree/main/pstack/skills/tdd into .gemini/skills/tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd", 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 cursor/plugins tddInstalls 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 cursor/plugins --skill tdd -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cursor/plugins.git skills-src && mkdir -p .github/skills && cp -r skills-src/pstack/skills/tdd .github/skills/tdd && 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" agent skill from https://github.com/cursor/plugins/tree/main/pstack/skills/tdd into .github/skills/tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd", 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 cursor/plugins --skill tdd -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cursor/plugins tdd --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cursor/plugins.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/pstack/skills/tdd .opencode/skills/tdd && 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" agent skill from https://github.com/cursor/plugins/tree/main/pstack/skills/tdd into .opencode/skills/tdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tdd", 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- GitHub stars
- 10k
- Used in
- 8 other repos
- Token cost
- ~786 tokens
- SKILL.md length
- 430 words
- Files
- 1
- Skills in repo
- 99
- Repo updated
- First seen
- Licence
- None found
At a glance
Fixes a bug with a failing regression test first when a cheap, focused test path exists, and falls back to the closest practical check when it does not.
- Works in 6 steps: Understand the bug. Identify the… → Choose the narrowest executable check.… → Write the failing test first. Add the… → …
- Fixing a bug that has a clear, cheap unit or component test target
- SKILL.md covers Workflow, If a Failing Test Is Impractical, Guardrails and Final Response
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
The skill is selective. It applies when you ask for TDD, a failing test or a regression test, or when a bug has an obvious inexpensive local test target, and it is skipped when the test path is unclear, costly or integration-heavy. The agent pins down intended behavior, current behavior and the smallest reproduction, picks the narrowest executable check already used for that code, and writes the smallest test that would have caught the bug.
It runs that test before touching the implementation to confirm it fails for the intended reason, makes the smallest production change, and reruns the test. When a failing test would need heavy harness setup, brittle mocks or production-only state, the agent uses a targeted script, a manual reproduction, browser automation, a snapshot comparison or a log assertion. A new test is better skipped than bad. Guardrails forbid editing tests to fit a wrong implementation or weakening assertions without a clear reason.
When your agent uses it
- Fixing a bug that has a clear, cheap unit or component test target
- You ask for a failing test or regression test before the fix
- Making a flaky bug deterministic so its test locks in the signal
Example prompts
- “Fix the rounding bug in the invoice total and add a regression test first.”
- “Use TDD to fix the date formatter returning the wrong month on the first day.”
- “Reproduce this pagination bug with a failing test before changing any code.”
Requirements
- A project with a test runner the agent can execute
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Understand the bug. Identify the intended behavior, current behavior, affected path, and smallest observable reproduction.
- Choose the narrowest executable check. Prefer the closest unit, component, integration, or regression test already used for that codepath…
- Write the failing test first. Add the smallest focused test that would have caught the bug. The test should encode intended behavior, not…
- Run the new test before fixing. Confirm it fails for the intended reason. If it passes or fails for an unrelated reason, correct the test…
- Fix the bug. Make the smallest production change that satisfies the intended behavior while preserving nearby contracts.
- Rerun the regression test. Confirm the test now passes.
What it can do on your machine
Read from SKILL.md and the folder at commit 9f451cf. 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 Bug Fix loads about 786 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 430 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
Without a licence we can't republish the file, so here is its outline and opening line. It has 430 words (~786 tokens).
“When fixing a bug with a clear, cheap test path, make the broken behavior executable before changing production code. The goal is a focused regression test that fails before the fix and passes after it.”
- name
- tdd
- disable-model-invocation
- true
Files
Just SKILL.md in pstack/skills/tdd of cursor/plugins.
Open the folder on GitHubat commit 9f451cf
Used in 8 other repositories
We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 8 other GitHub owners. This page covers the copy in cursor/plugins, which our catalogue first saw on October 7, 2026.
- chmonitor/chmonitor.claude/skills/pstack/upstream/skills/tdd
- Sma1lboy/rove.agents/skills/pstack/skills/tdd
- michael-denyer/pstack-claudeplugins/pstack/skills/tdd
- backnotprop/pstackskills/tdd
- tellahq/opensession.agents/skills/pstack-suite/skills/tdd
- am-will/gooey-pi.agents/skills/pstack/tdd
- jtaroreh/agystackskills/tdd
- uzairansaruzi/p3-stackskills/tdd
Compare with similar skills
TDD Bug Fix 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 Bug Fix this skillcursor/plugins | 10k | 8 repos | ~786 | Automated safety check: Pass | None | |
| Test Guidelinesgetsentry/sentry-dart | 873 | — | ~3.1k | Automated safety check: Pass | MIT | |
| Agent Harness Testing Methodologyhuiliyi37/Tianshu-harness | 1.1k | — | ~1k | Automated safety check: Notes | Apache-2.0 | |
| Opsmill Dev Test Driving Bugsopsmill/infrahub | 529 | — | ~4k | Automated safety check: Pass | Apache-2.0 | |
| Bug FixEmeaAppGbb/spec2cloud | 100 | — | ~2k | Automated safety check: Pass | MIT | |
| Systematic Debuggingforyourhealth111-pixel/Vibe-Skills | 3.6k | — | ~2.6k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Agent Harness Testing Methodology
huiliyi37/Tianshu-harness
Guides an agent through probing an unfamiliar project's test setup, then choosing a red-light-first testing strategy matched to the task type.
Opsmill Dev Test Driving Bugs
opsmill/infrahub
Writes a single failing test that reproduces a bug after its root-cause analysis is complete, before any fix is written.
Bug Fix
EmeaAppGbb/spec2cloud
Lightweight entry point for fixing bugs with full traceability.
Systematic Debugging
foryourhealth111-pixel/Vibe-Skills
Root-cause route for actual bugs, failing tests, build errors, crashes, stack traces, and unexpected behavior.
Aidd Fix
paralleldrive/aidd
Fix a bug or implement review feedback following the AIDD fix process.
More from cursor/plugins
All 99 skills in this repo- Official
Show Me Your Work Decision Log
cursor/plugins
Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.
- Official
Code Design Rationale Investigator
cursor/plugins
Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.
- Official
Reflect on Session Learnings
cursor/plugins
Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.
- Official
Technical Writing Standard
cursor/plugins
Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.
- Official
Advisor Mode
cursor/plugins
Adds a second, stronger model that the main agent consults before major decisions, when stuck and before finishing, controlled by /advisor commands.
- Official
Make PR Easy To Review
cursor/plugins
Prepare PRs for review by cleaning noisy history, improving PR descriptions, and adding reviewer guidance without changing code behavior.
Related
Categories
Questions about TDD Bug Fix
What does TDD Bug Fix do?
Fixes a bug with a failing regression test first when a cheap, focused test path exists, and falls back to the closest practical check when it does not. The skill is selective. It applies when you ask for TDD, a failing test or a regression test, or when a bug has an obvious inexpensive local test target, and it is skipped when the test path is unclear, costly or integration-heavy.
When should I use TDD Bug Fix?
TDD Bug Fix fits situations like: fixing a bug that has a clear, cheap unit or component test target; you ask for a failing test or regression test before the fix; making a flaky bug deterministic so its test locks in the signal.
How do I install TDD Bug Fix in Claude Code?
Run `npx skills add cursor/plugins --skill tdd -a claude-code`. Or copy the skill folder (pstack/skills/tdd in cursor/plugins) into .claude/skills/tdd in your project. Claude Code loads it when a task matches its description.
How do I install TDD Bug Fix in Codex?
Run `npx skills add cursor/plugins --skill tdd -a codex`. Or copy the skill folder (pstack/skills/tdd in cursor/plugins) into .agents/skills/tdd in your project. Codex loads it when a task matches its description.
Can I use TDD Bug Fix 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 cursor/plugins --skill tdd -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, .gemini/skills/tdd, .github/skills/tdd and .opencode/skills/tdd in your project.
What does TDD Bug Fix need to run?
SKILL.md names no scripts, command-line tools or credentials: TDD Bug Fix is instructions for the agent only. Our summary lists: A project with a test runner the agent can execute.
Does TDD Bug Fix 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 Bug Fix 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 Bug Fix use?
No licence was found for TDD Bug Fix or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does TDD Bug Fix use?
About 786 tokens (SKILL.md is roughly 3.1k 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 Bug Fix?
Skills that share tags, products or a category with TDD Bug Fix: Test Guidelines (getsentry/sentry-dart, 873 stars), Agent Harness Testing Methodology (huiliyi37/Tianshu-harness, 1.1k stars), Opsmill Dev Test Driving Bugs (opsmill/infrahub, 529 stars) and Bug Fix (EmeaAppGbb/spec2cloud, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains TDD Bug Fix?
cursor (a GitHub organization, an official publisher) maintains it in cursor/plugins, which has 10,130 GitHub stars. The repository holds 99 skills in this directory. The repository was last updated on October 6, 2026.
Source: cursor/plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.