spec

Translate vague product goals into verifiable specifications with user stories and acceptance criteria.

28|2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/labs21-dev/agents-stack --skill spec-labs21-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/labs21-dev/agents-stack/tree/main/templates/.agents/skills/using-agents-stack/spec
Command: npx skills add https://github.com/labs21-dev/agents-stack --skill spec-labs21-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate vague product intent into a precise, verifiable specification that defines what to build without prescribing implementation details.

Core Features & Use Cases

  • Convert high-level goals into concrete user stories and acceptance criteria for a shared understanding.
  • Identify edge cases and failure paths up front to guide QA and validation.
  • Produce a structured spec (spec.md) in the active workstream directory with clear traceability to inputs and outputs.

Quick Start

Provide a brief product goal or user need, and the Spec Worker will generate a complete spec.md with USs, ECs, and ACs.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn vague product goals into verifiable acceptance criteria?

You can turn vague product goals into verifiable acceptance criteria by providing a brief intent to generate a structured spec.md file containing concrete user stories, edge cases, and acceptance criteria.

What is the best way to define user stories and edge cases before development?

The best way to define user stories and edge cases is translating high-level goals into a precise specification document that identifies failure paths up front to guide QA and validation efforts.

How does goal articulation translate into a specification ready for QA?

Goal articulation translates into a QA-ready specification by processing goal documents to produce a verifiable spec.md file and updating status.json to phase 'spec' to signal review readiness.

Can I use BDD principles to structure product specifications from a brief goal?

Yes, you can apply BDD principles to structure product specifications from a brief goal by generating verifiable user stories and acceptance criteria that define expected behaviors without prescribing implementation details.

When do I need a formal specification document for workstream tracking?

You need a formal specification document for workstream tracking when you must transition a shared understanding of what to build into a structured spec.md with clear traceability to inputs and outputs.