spec

Generates traceable technical specifications with requirements, acceptance criteria, and test plans.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/karenrebecag/spec-driven-standards --skill spec-karenrebecag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/karenrebecag/spec-driven-standards/tree/main/plugins/product/skills/spec
Command: npx skills add https://github.com/karenrebecag/spec-driven-standards --skill spec-karenrebecag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an approved discovery into an implementable specification is often where requirements become vague, unverifiable, or untraceable. This Skill converts a discovery into a structured spec that planners can implement, QA reviewers can verify, and release steps can expose, with every requirement traced back to a discovery need and an acceptance criterion. ## Core Features & Use Cases - Traceable Requirements: Generates numbered functional and non-functional requirements, each verifiable and tied to a discovery need, with thresholds instead of adjectives (e.g., "< 200ms p95" instead of "fast"). - Acceptance Criteria & Test Plan: Produces given/when/then acceptance criteria per requirement plus a test plan covering unit, integration, and e2e scope, including what is excluded and why. - Phased Scoping: Enforces environment constraints (3-5 files per change) and splits oversized work into mergeable phases: minimal, happy path, edge cases, optimization. - Use Case: After approving a discovery for a new checkout feature, invoke /spec to produce the full specification covering data model changes, dependencies, security surfaces, and acceptance criteria, then approve it before implementation begins. ## Quick Start Ask the AI to run /spec on the approved discovery document to generate a traceable specification with requirements, acceptance criteria, and a test plan.

Frequently Asked Questions about spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a software specification from a discovery document?

Run /spec on an approved discovery to generate a structured spec with an objective, numbered functional and non-functional requirements, acceptance criteria, data changes, dependencies, security surfaces, and a test plan. Each requirement traces back to a discovery need.

What makes a requirement verifiable in a technical spec?

A requirement is verifiable when you can write an acceptance criterion for it in given/when/then form. Non-functional requirements need measurable thresholds like "< 200ms p95" rather than adjectives like "fast" or "scalable".

How does the spec skill fit into a spec-driven development workflow?

It sits between discovery and implementation: /discover produces the approved discovery, /spec converts it into a specification, then /ship implements and reviews it, followed by /release, /observe, and /learn. The spec requires explicit approval before implementation.

What happens when a specification is too large to implement in one change?

The spec enforces a limit of 3-5 files per change. When work exceeds that, the spec itself declares the split and breaks the work into mergeable phases: minimal version, happy path, edge cases, then optimization.

Can the spec skill be invoked automatically by the AI?

No. The skill sets disable-model-invocation to true, so it only runs through manual invocation with /spec. This keeps specification generation as a deliberate, human-approved checkpoint before implementation.