Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add open-gsd/gsd-core --skill gsd-add-tests -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/gsd-add-tests/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gsd-add-tests/

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

Similar skills

All skills for Testing and QA →

From the same set72

The whole set →
gsd-extract-learnings gsd-extract-learnings is a Claude Code skill that analyzes completed-phase artifacts and saves structured insights to a separate file. It runs after tasks finish to capture engineering lessons. CX Codex +1 577installs gsd-resume-work The gsd-resume-work Claude Code skill restores project context after an earlier session. It checks unfinished work and selects a context-aware next step. CX Codex +1 577installs gsd-docs-update gsd-docs-update is a Claude Code skill that creates or revises project docs against the codebase. It can audit existing files or run a full documentation pass. CX Codex +1 576installs gsd-review-backlog The gsd-review-backlog Claude Code skill reviews backlog entries and offers to move them into the active milestone or delete them. It handles 999.x phases in a project. CX Codex +1 576installs gsd-spec-phase The gsd-spec-phase Claude Code skill clarifies a project phase’s requirements and creates a SPEC.md before implementation planning. It inspects the codebase, interviews the user, then scores ambiguity in the answers. CX Codex +1 575installs gsd-inbox gsd-inbox — a skill for Claude Code that reviews GitHub issues and pull requests against project templates. Runs to automate inbox triage and check compliance with contribution guidelines. CX Codex +1 574installs gsd-stats The gsd-stats Claude Code skill reports project progress and metrics. Ask it to summarize phases, plans, requirements, Git history, or the project timeline. CX Codex +1 574installs gsd-ns-workflow gsd-ns-workflow — a skill for Claude Code that routes development tasks through specific workflow phases. It triggers sub-skills for planning, execution, verification, and project advancement. CX Codex +1 574installs

Project sponsors

Companies that keep this analytics open