skills.rest
shysssthanhtri
shysssthanhtriCOMMUNITY
Explore all skills by this author →
GitHub

create-specification

Create machine-readable specification documents using a structured Markdown template with YAML front matter.

Updated Mar 19, 2026
Search Tags:#template#documentation#interfaces#specification#requirements#ai-ready#acceptance-criteria
One-click install
npx skills add https://github.com/shysssthanhtri/AI-tools --skill create-specification-shysssthanhtri
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-specification
Source: https://github.com/shysssthanhtri/AI-tools/tree/main/skills/create-specification
Command: npx skills add https://github.com/shysssthanhtri/AI-tools --skill create-specification-shysssthanhtri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating clear, unambiguous, and machine-readable specification documents is time-consuming and often inconsistent, which reduces their usefulness for automated workflows and generative AI agents. This Skill standardizes the structure and content of specifications so requirements, interfaces, and acceptance criteria are explicit and consumable by AI tools.

Core Features & Use Cases

  • Structured Template Enforcement: Provides a complete Markdown template with required YAML front matter and mandated sections for requirements, interfaces, tests, and dependencies.
  • AI-Optimized Output: Emphasizes machine-readable language, explicit definitions, and examples so generative models can reliably interpret and act on the spec.
  • File Naming & Storage Conventions: Enforces naming like spec-[a-z0-9-]+.md and placement in /spec/ to support discoverability and automation pipelines.
  • Use Case: Draft a new infrastructure spec that lists constraints, acceptance criteria, and test automation strategy to hand off to engineering and CI pipelines.

Quick Start

Create a specification for a payment-processing schema that lists purpose, requirements, constraints, interfaces, acceptance criteria, testing strategy, and save it as spec-schema-payment-processing.md in the /spec/ directory.

Frequently Asked Questions about create-specification

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

FAQPage Schema
How do I generate AI-ready technical specifications for software components?▼

AI-ready specifications enforce a structured Markdown template with YAML front matter, explicitly defining requirements, interfaces, acceptance criteria, and test strategies for reliable machine consumption by generative models.

What is the best way to structure requirements and interfaces for automated CI pipelines?▼

Structure requirements and interfaces for CI pipelines by enforcing standardized file naming like spec-[a-z0-9-]+.md and saving them in a /spec/ directory, ensuring explicit acceptance criteria and test automation strategies are embedded for automated workflows.

How do I write machine-readable specification documents for infrastructure and data schemas?▼

Write machine-readable specification documents by applying a standardized template with mandated sections for dependencies and validation criteria, ensuring infrastructure and data schemas are unambiguous and consumable by AI tools.

Can I use this specification template for documenting processes and architectures, or only for data schemas?▼

Yes, you can use this specification template for documenting processes and architectures, as it applies to schemas, tools, data, infrastructure, processes, architectures, and designs when drafting requirements and interfaces.

Why do my AI agents struggle to interpret and act on unstructured specification documents?▼

AI agents struggle with unstructured specification documents because they lack machine-readable language and explicit definitions, which standardized templates with YAML front matter and mandated sections are designed to resolve.

What file naming and storage conventions are required for AI-optimized specification documents?▼

AI-optimized specification documents require a spec-[a-z0-9-]+.md filename convention and placement in a /spec/ directory to support discoverability and automation pipelines.

Related Skills

Explore More Software Engineering Skills→
I2olanDI2olanD

architecture-design

Generate and validate Solution Design Documents against PRD requirements.

Community
Advanced
madebyarismadebyaris
192

sdd-evolve

Update specification files and changelog after implementation discoveries.

Community
Intermediate
arrrrnyarrrrny

skill-builder

Create standardized cli_sync skills with YAML front matter and Markdown documentation.

Community
Intermediate
xashggxashgg
1

verify-claims

Verify factual claims in text drafts against external sources.

Community
Intermediate