skills.rest
josorio7122
josorio7122COMMUNITY
Explore all skills by this author →
GitHub

spec

Generate complete Spec-Driven Development specifications with eight structured artifacts.

1|Updated Feb 22, 2026
Search Tags:#documentation#software design#specification#data modeling#sdd#api contract
One-click install
npx skills add https://github.com/josorio7122/pi-flow --skill spec-josorio7122
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/josorio7122/pi-flow/tree/main/skills/spec
Command: npx skills add https://github.com/josorio7122/pi-flow --skill spec-josorio7122

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of comprehensive software specifications, ensuring clarity, consistency, and completeness from initial concept to detailed design.

Core Features & Use Cases

  • Full SDD Spec Generation: Produces all required artifacts including Glossary, Constitution, Data Model, subsystem specs, API contracts, and UI behavioral specs.
  • Structured Interview Process: Guides users through a systematic interview to gather all necessary information.
  • Compliance Checks: Integrates rigorous checks at each phase to ensure adherence to Spec-Driven Development standards.
  • Use Case: When starting a new software project or feature, use this Skill to generate a detailed, actionable specification that serves as the single source of truth for development.

Quick Start

Use the spec skill to create a new specification for a user authentication service.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I generate complete software specifications for a new platform?▼

Software specification generation for new platforms uses a structured interview process to produce eight SDD artifacts, including a glossary, data model, subsystem specs, and API contracts, ensuring clarity and completeness from initial concept to detailed design.

What is Spec-Driven Development and how does it structure API contracts?▼

Spec-Driven Development structures API contracts by enforcing compliance checks and phased validation across generated artifacts like specs/06-api.md, using anti-pattern detection to ensure adherence to design principles and data modeling consistency.

Can I use this to create a data model and UI behavioral specs for a user authentication service?▼

Yes, you can create a data model and UI behavioral specs for a user authentication service; the process outputs DATA-MODEL.md and specs/07-ui.md alongside other artifacts, serving as a single source of truth for development.

What's the best way to document software design across multiple subsystems?▼

The best way to document software design across multiple subsystems uses an automated SDD approach that generates per-subsystem specs, a constitution, and an overview document, enforcing consistency and compliance through structured interviews.

Do I need prior documentation to start generating an SDD specification?▼

You do not need prior documentation to start generating an SDD specification; the process guides you through a systematic structured interview to gather all necessary information directly from your initial software concept.

Why does software specification generation include anti-pattern detection?▼

Software specification generation includes anti-pattern detection to ensure adherence to SDD principles, integrating rigorous compliance checks at each phase to validate the data model, API contracts, and overall software design.

Related Skills

Explore More Software Engineering Skills→
TobiasBakTobiasBak

interview-project

Interview project stakeholders and generate a SPEC.md with requirements and decisions.

Community
Advanced
ivfariasivfarias
22

speckit-plan

Generate data-model.md, API contracts, and quickstart.md from a specification and constitution.

Community
Advanced
aurora-atomsaurora-atoms

pr-ready-package

Synthesize code diffs, delivery evidence, and project context into a structured pull request package.

Community
Advanced
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic