TDD
fossasia/eventyay-interpretation
Test-driven development. An agent skill from fossasia/eventyay-interpretation.
Apply Test-Driven Development workflow for new features and bugfixes.
Install TDD
$ npx skills add smartfrog/opencode-froggy --skill tdd -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install smartfrog/opencode-froggy 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/smartfrog/opencode-froggy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill/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/smartfrog/opencode-froggy/tree/main/skill/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/smartfrog/opencode-froggy/tree/main/skill/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 smartfrog/opencode-froggy --skill tdd -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install smartfrog/opencode-froggy tdd --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/smartfrog/opencode-froggy.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skill/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/smartfrog/opencode-froggy/tree/main/skill/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 smartfrog/opencode-froggy --skill tdd -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install smartfrog/opencode-froggy tdd --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/smartfrog/opencode-froggy.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skill/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/smartfrog/opencode-froggy/tree/main/skill/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/smartfrog/opencode-froggy.git --path skill/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 smartfrog/opencode-froggy --skill tdd -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install smartfrog/opencode-froggy tdd --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/smartfrog/opencode-froggy.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skill/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/smartfrog/opencode-froggy/tree/main/skill/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 smartfrog/opencode-froggy 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 smartfrog/opencode-froggy --skill tdd -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/smartfrog/opencode-froggy.git skills-src && mkdir -p .github/skills && cp -r skills-src/skill/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/smartfrog/opencode-froggy/tree/main/skill/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 smartfrog/opencode-froggy --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 smartfrog/opencode-froggy tdd --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/smartfrog/opencode-froggy.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skill/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/smartfrog/opencode-froggy/tree/main/skill/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
- 106
- Token cost
- ~751 tokens
- SKILL.md length
- 386 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- MIT
At a glance
Apply Test-Driven Development workflow for new features and bugfixes.
- Works in 6 steps: Requirement Synthesis: Briefly summarize… → Red: Choose one observable behavior,… → Green: Write the minimum implementation… → …
- Tasks that involve Test-driven development
- SKILL.md covers Core Principle, Workflow, Mandatory Rules and Preferred Practice, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
TDD is an agent skill from smartfrog/opencode-froggy. Apply Test-Driven Development workflow for new features and bugfixes.
Its SKILL.md is about 750 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. The licence is MIT.
When your agent uses it
- Tasks that involve Test-driven development
Example prompts
- “/tdd”
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Requirement Synthesis: Briefly summarize the requirements before coding.
- Red: Choose one observable behavior, write its test, and run it. Confirm it fails because that behavior is missing or incorrect, not…
- Green: Write the minimum implementation that makes this test pass. Run relevant existing tests to detect regressions.
- Refactor: Improve the changed code and tests where useful without changing behavior; keep tests green. Make no refactor when none is…
- Repeat steps 2–4 for the next behavior. Keep this loop inside the implementing agent while the ticket is In progress; do not write the…
- Run the project's required checks before delivery. Report commands, results, the observed failure and subsequent success, and any…
What it can do on your machine
Read from SKILL.md and the folder at commit 77779bd. 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 loads about 751 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 386 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 smartfrog/opencode-froggy at commit 77779bd, republished under its MIT licence (© smartfrog). 386 words, ~751 tokens.
Download SKILL.mdSave it as
.claude/skills/tdd/SKILL.md (or your agent's skills folder).- name
- tdd
- description
- Apply Test-Driven Development workflow for new features and bugfixes.
TDD Protocol
Core Principle
- TDD First: Test-Driven Development is the default approach.
- Goal: Prioritize behavioral correctness and regression safety over formal compliance.
Workflow
- Requirement Synthesis: Briefly summarize the requirements before coding.
- Red: Choose one observable behavior, write its test, and run it. Confirm it fails because that behavior is missing or incorrect, not because of a broken fixture or environment. For a bug, reproduce it before fixing it.
- Green: Write the minimum implementation that makes this test pass. Run relevant existing tests to detect regressions.
- Refactor: Improve the changed code and tests where useful without changing behavior; keep tests green. Make no refactor when none is justified.
- Repeat steps 2–4 for the next behavior. Keep this loop inside the implementing agent while the ticket is In progress; do not write the entire test suite first or delegate test, code, and refactor as separate tasks.
- Run the project's required checks before delivery. Report commands, results, the observed failure and subsequent success, and any justified exception. Never claim a red/green cycle that was not actually executed.
Mandatory Rules
- No Test, No Code: Every new feature or bugfix must include relevant test coverage.
- Black-Box Testing: Validate observable behavior, not internal implementation details.
- Merge Requirement: Tests are mandatory for completion unless an explicit exception is documented.
Show full SKILL.md (168 more words)Show less
Preferred Practice
- Short feedback loops: Use Red-Green-Refactor by default for features and bugfixes; exceptions below require a reason and an appropriate alternative verification.
- Right-Sized Testing:
- Unit Tests: For pure logic and isolated functions.
- Integration Tests: For system interactions and API boundaries.
- E2E Tests: For critical user journeys and "happy paths."
Explicit Exceptions (Must be justified)
- Pure refactoring: run existing behavior tests before and after; add characterization coverage first when necessary.
- Documentation-only changes: check accuracy, links, or examples as appropriate rather than adding artificial unit tests.
- Exploratory spikes or R&D: report findings and limitations; apply production checks before promoting experimental code.
- UI/Styling iterations where unit tests offer diminishing returns: use visual or interaction verification.
- Complex integrations where mocking is counterproductive: use integration or contract checks when feasible; document unavailable environments and do not claim unexecuted checks passed.
- Emergency hotfixes (requires a follow-up ticket for test debt).
Quality Bar
- Readability: Tests must serve as documentation for the feature.
- Reliability: Tests must be deterministic (no flakes) and decoupled from implementation internals.
© smartfrog, MIT. 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 skill/tdd of smartfrog/opencode-froggy.
Open the folder on GitHubat commit 77779bd
Compare with similar skills
TDD 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 this skillsmartfrog/opencode-froggy | 106 | — | ~751 | Automated safety check: Pass | MIT | |
| TDDfossasia/eventyay-interpretation | 1.6k | 28 repos | ~1.1k | Automated safety check: Pass | Apache-2.0 | |
| TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph | 112 | 11 repos | ~2.4k | Automated safety check: Pass | None | |
| TDDsanity-io/sanity | 6.4k | 20 repos | ~1k | Automated safety check: Pass | MIT | |
| Test Driven Developmentfarm-fe/farm | 5.6k | 49 repos | ~2.5k | Automated safety check: Pass | MIT | |
| Tapd Story PipelineTencentBlueKing/bk-bcs | 840 | — | ~2.6k | Automated safety check: Pass | Custom licence |
Similar skills
TDD Workflow
hellangleZ/burn-in-cceverywhere-ralph
A skill your agent uses when writing new features, fixing bugs, or refactoring code.
- Official
TDD
sanity-io/sanity
Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.
Test Driven Development
farm-fe/farm
A skill your agent uses when implementing any feature or bugfix, before writing implementation code
Tapd Story Pipeline
TencentBlueKing/bk-bcs
单需求实现流水线——把一个 TAPD 需求从零推进到代码提交。自动串联技术澄清、 开发计划、任务拆分、TDD 实现、架构/安全校验、代码提交六个阶段。
Absolute Init
maddhruv/absolute
One-time setup for absolute: interview how you want it to behave (output style, autonomy, TDD strictness, spec dir, families) + detect the stack once, then write .absolute.config.json (project…
More from smartfrog/opencode-froggy
Ask Questions If Underspecified
smartfrog/opencode-froggy
Clarify requirements before implementing. An agent skill from smartfrog/opencode-froggy.
Backlog Management
smartfrog/opencode-froggy
Manage ticket responsibilities, workflow, and capacity through Linear/Trello MCP tools or a Markdown fallback.
Extreme Programming
smartfrog/opencode-froggy
Apply XP principles through simple evolving design, short feedback loops, and shared engineering responsibility.
Related
Categories
Questions about TDD
What does TDD do?
Apply Test-Driven Development workflow for new features and bugfixes. TDD is an agent skill from smartfrog/opencode-froggy. Apply Test-Driven Development workflow for new features and bugfixes.
When should I use TDD?
TDD fits situations like: tasks that involve Test-driven development.
How do I install TDD in Claude Code?
Run `npx skills add smartfrog/opencode-froggy --skill tdd -a claude-code`. Or copy the skill folder (skill/tdd in smartfrog/opencode-froggy) into .claude/skills/tdd in your project. Claude Code loads it when a task matches its description.
How do I install TDD in Codex?
Run `npx skills add smartfrog/opencode-froggy --skill tdd -a codex`. Or copy the skill folder (skill/tdd in smartfrog/opencode-froggy) into .agents/skills/tdd in your project. Codex loads it when a task matches its description.
Can I use TDD 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 smartfrog/opencode-froggy --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 need to run?
SKILL.md names no scripts, command-line tools or credentials: TDD is instructions for the agent only.
Does TDD 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 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 use?
TDD is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does TDD use?
About 751 tokens (SKILL.md is roughly 3k 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?
Skills that share tags, products or a category with TDD: TDD (fossasia/eventyay-interpretation, 1.6k stars), TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars), TDD (sanity-io/sanity, 6.4k stars) and Test Driven Development (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains TDD?
smartfrog (a GitHub organization) maintains it in smartfrog/opencode-froggy, which has 106 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 28, 2026.
Source: smartfrog/opencode-froggy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.