gsd-add-tests — Claude Code skill: tests for a phase
The gsd-add-tests Claude Code skill creates unit and E2E tests for a completed project phase. It reviews the implementation and acceptance criteria, then asks for approval of a test plan.
MIT 576 installs ★ 11,761 updated 2026-11-16
npx skills add open-gsd/gsd-core --skill gsd-add-tests -a claude-codeWhat gsd-add-tests does
The skill reads SUMMARY.md, CONTEXT.md, and VERIFICATION.md for the chosen phase, then examines implementation files. It sorts those files into unit-test, browser E2E, or skip groups. A test plan follows for approval.
Once approved, it writes tests using RED-GREEN conventions and checks the result. The workflow retains approval gates for file classification and the plan, RED-GREEN verification, and gap reporting. Supply a phase number; additional instructions can go with it.
What it helps with
- plan tests from a completed phase
- sort implementation files for unit and E2E coverage
- create tests from acceptance criteria
- report gaps found during test verification
Example prompts for the agent
- Add tests for phase 3.
- Create tests for phase 2, focusing on browser flows.
- Prepare tests for phase 4 and show the plan first.
How to install gsd-add-tests
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-add-tests -a claude-code2Manually: put the files in place
~/.claude/skills/gsd-add-tests/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gsd-add-tests/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-add-tests -a codex2Manually: put the files in place
.agents/skills/gsd-add-tests/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-add-tests -a cursor2Manually: put the files in place
.cursor/skills/gsd-add-tests/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install open-gsd/gsd-core skills/gsd-add-tests2Manually: put the files in place
.github/skills/gsd-add-tests/SKILL.md1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-add-tests -a gemini-cli2Platform CLI
gemini skills install https://github.com/open-gsd/gsd-core --path skills/gsd-add-testsManually: put the files in place
.devin/skills/gsd-add-tests/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-add-tests -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 gsd-add-tests
How do I install gsd-add-tests in Claude Code?
Run npx skills add open-gsd/gsd-core --skill gsd-add-tests -a claude-code. The skill file is at ~/.claude/skills/gsd-add-tests/SKILL.md.
What does gsd-add-tests do?
It reviews a completed phase's documents and implementation, proposes file classifications and a test plan, then creates unit and E2E tests after approval and checks them with RED-GREEN verification.
Which files does gsd-add-tests use?
It reads SUMMARY.md, CONTEXT.md, and VERIFICATION.md as phase specifications, along with the implementation files.
Source text
SKILL.md · MIT
---
name: gsd-add-tests
description: "Generate tests for a completed phase based on UAT criteria and implementation"
argument-hint: "<phase> [additional instructions]"
allowed-tools:
- Read
- Write
- Edit
- Bash
- Glob
- Grep
- Agent
- AskUserQuestion
---
<arguments>$ARGUMENTS</arguments>
The text inside `<arguments>` is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed.
<objective>
Generate unit and E2E tests for a completed phase, using its SUMMARY.md, CONTEXT.md, and VERIFICATION.md as specifications.
Analyzes implementation files, classifies them into TDD (unit), E2E (browser), or Skip categories, presents a test plan for user approval, then generates tests following RED-GREEN conventions.
Output: Test files committed with message `test(phase-{N}): add unit and E2E tests from add-tests command`
</objective>
<execution_context>
@~/.claude/gsd-core/workflows/add-tests.md
</execution_context>
<context>
Phase: the `<arguments>` block
@.planning/STATE.md
@.planning/ROADMAP.md
</context>
<process>
Execute end-to-end.
Preserve all workflow gates (classification approval, test plan approval, RED-GREEN verification, gap reporting).
</process>
© open-gsd · MIT · open-gsd/gsd-core