skills.rest
giovi1998
giovi1998COMMUNITY
Explore all skills by this author →
GitHub

create-specification

Creates self-contained Markdown spec documents with YAML front matter and validation criteria.

Updated Jun 15, 2026
Search Tags:#testing#documentation#markdown#interfaces#specification#requirements
One-click install
npx skills add https://github.com/giovi1998/SitoPreventivo --skill create-specification-giovi1998
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-specification
Source: https://github.com/giovi1998/SitoPreventivo/tree/main/.agents/skills/.agents/skills/create-specification
Command: npx skills add https://github.com/giovi1998/SitoPreventivo --skill create-specification-giovi1998

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a solution idea into a clear, structured specification that defines what must be built, how it should behave, and how it will be validated.

Core Features & Use Cases

  • AI-ready structure: Produces self-contained Markdown with explicit sections for scope, definitions, requirements, interfaces, testing, and dependencies.
  • Requirement clarity: Separates requirements, constraints, guidelines, and acceptance criteria so implementation teams can act without ambiguity.
  • Use case: Use it when you need a specification for a new feature, service, workflow, architecture change, or design system component.

Quick Start

Ask the skill to create a specification for your target solution and provide the purpose, scope, and key constraints in plain language.

Frequently Asked Questions about create-specification

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

FAQPage Schema
How do I create an AI-ready specification document for a new software feature?▼

Create a specification by defining your solution's purpose, scope, and constraints in plain language to generate structured Markdown with explicit acceptance criteria and interface definitions.

What is the best way to define requirements and data contracts for infrastructure changes?▼

Defining requirements for infrastructure changes requires mapping dependencies and data contracts within a self-contained Markdown specification to ensure implementation teams act without ambiguity.

How do I write acceptance criteria and test plans in Markdown format?▼

Write acceptance criteria in Markdown by generating a specification document that separates testing requirements, validation criteria, and scope definitions into explicit, structured sections.

Can I use this specification approach for design system components and workflows?▼

Yes, this specification approach supports design system components, workflows, and processes by drafting structured requirement documents with clear dependency mapping and interface definitions.

Does the generated specification include YAML front matter for dependency mapping?▼

Yes, the generated specification includes YAML front matter to map dependencies and define metadata, ensuring the Markdown document remains self-contained and machine-readable.

What limitations exist when drafting specification documents for complex solution components?▼

The specification drafting process requires you to provide purpose and scope inputs upfront, meaning incomplete constraints will yield ambiguous requirements for implementation teams.

Related Skills

Explore More Software Engineering Skills→
javierteliozjaviertelioz

create-specification

Generate Markdown specification documents with YAML frontmatter in the spec/ directory.

Community
Intermediate
epieczkoepieczko

epic.decompose

Parse Markdown Epic documents and generate structured user stories as JSON.

Community
Intermediate
Eric-Pacheco95Eric-Pacheco95

acceptance-criteria

Convert user stories into Given-When-Then acceptance criteria in Gherkin format or checklist.

Community
Intermediate
fabioabrfabioabr

prs-writer

Convert Markdown documents into standalone HTML presentations using templates.

Community
Advanced