spec-creation

Create implementation specifications with acceptance criteria and demo scripts.

395|84|Updated Oct 5, 2025

Search Tags:#validation #pattern #spec #demo #acceptance-criteria

Ready to run

npx skills add https://github.com/bybren-llc/wtfb-safe-agentic-workflow --skill spec-creation

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spec-creation
Source: https://github.com/bybren-llc/wtfb-safe-agentic-workflow/tree/main/.claude/skills/spec-creation
Command: npx skills add https://github.com/bybren-llc/wtfb-safe-agentic-workflow --skill spec-creation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec creation with pattern references, acceptance criteria, and demo scripts. Use when creating implementation specs, defining acceptance criteria, or breaking down user stories.

Core Features & Use Cases

Acceptance Criteria: testable
Pattern References: existing patterns
Demo Script: for validation
Spec Template: mandatory

Quick Start

Create SPEC-{TICKET_PREFIX}-001 using the template and attach pattern references

Frequently Asked Questions about spec-creation

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

FAQPage Schema

How do I create implementation specs with acceptance criteria?▼

Implementation specs with acceptance criteria organize requirements into testable conditions. Use the mandatory SPEC template with sections for Summary, User Story, Acceptance Criteria, Pattern References, Success Validation, and Demo Script to ensure each criterion is measurable and verifiable before development begins.

What's the best way to break down user stories into technical specifications?▼

Break user stories into technical specs by applying the SPEC template: define acceptance criteria as testable conditions, reference existing patterns for implementation guidance, attach demo scripts for validation, and map logical commits to output locations. This creates traceability from business requirements to runnable code.

How do I add pattern references to specification documents?▼

Pattern references connect specs to existing implementations. Include a dedicated Pattern References section in your SPEC that links to proven solutions within your codebase or architecture library, enabling engineers to follow established approaches and reducing design ambiguity.

Can I use demo scripts to validate acceptance criteria?▼

Yes. Demo scripts provide runnable validation commands that verify acceptance criteria are met. Include executable commands in your SPEC's Demo Script section that engineers can run during development and QA to confirm the implementation satisfies all testable requirements.

What should a technical spec include for developers?▼

A complete technical spec includes Summary, User Story, testable Acceptance Criteria, Pattern References to existing solutions, Success Validation steps, runnable Demo Script, Logical Commits timeline, and Output Locations. This structure ensures developers have all context needed to implement and validate work.