mini-sdd-spec

Creates structured spec.yaml feature specifications with testable requirements and dependency tracking.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/AlessioScarfone/aine-copilot-plugins --skill mini-sdd-spec-alessioscarfone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mini-sdd-spec
Source: https://github.com/AlessioScarfone/aine-copilot-plugins/tree/main/src/mini-sdd/skills/mini-sdd-spec
Command: npx skills add https://github.com/AlessioScarfone/aine-copilot-plugins --skill mini-sdd-spec-alessioscarfone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Turning vague feature ideas into unambiguous, testable requirements is hard, and unstructured notes break down when handed to an AI agent or another developer. This Skill captures a single feature as a structured spec.yaml contract with stable requirement IDs, cross-cutting constraints, and dependency tracking. ## Core Features & Use Cases - Guided requirement interview: Asks targeted questions about behavior, users, functional requirements, and constraints, then groups answers into UPPER_SNAKE component keys with numbered, testable requirements. - Create and update flows: Detects existing specs by name or content similarity, then either creates a new spec.yaml from a template or updates an existing one while keeping requirement IDs (ACIDs) stable. - Dependency inference: Scans other specs in the project to infer requires relationships and manages the draft status lifecycle that hands off to the planning step. - Use Case: You want to add CSV export to your app. Run the skill, answer a short interview, and get specs/csv-export/spec.yaml with grouped requirements, constraints, and inferred dependencies ready for planning. ## Quick Start Ask the AI to create a spec for user authentication using the mini-sdd-spec skill.

Frequently Asked Questions about mini-sdd-spec

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

FAQPage Schema
How do I write a feature specification for AI-driven development?▼

Run the skill with a feature name, then answer a short numbered interview covering behavior, target user, functional requirements, and constraints. The skill writes a structured spec.yaml with grouped, testable requirements that an AI agent can turn into an implementation plan.

How to structure functional requirements in a spec.yaml file?▼

Group requirements into components with UPPER_SNAKE keys like LOGIN or EXPORT, and number each requirement as an integer with optional one-level sub-requirements. Each requirement gets a stable ACID in the form spec-name.GROUP_KEY.ID and must be observable and pass/fail testable.

Can I update an existing spec without breaking requirement IDs?▼

Yes. The update flow reads the current spec.yaml, applies changes, and appends new requirement numbers so existing IDs and ACIDs stay stable. It also re-infers dependencies and resets the status to draft so the plan gets regenerated.

Does this skill generate the implementation plan too?▼

No. It produces only the spec.yaml contract and sets status to draft. The implementation plan is generated separately by the mini-sdd-plan skill, which advances the spec to ready status.

What happens if a spec with the same name already exists?▼

The skill detects exact name matches and content similarity, shows the existing spec's status, and asks whether to update it or create a new spec under a different name. This prevents accidental overwrites of unrelated specs.