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.