spec-writing

Create and validate SPEC.md documents with templates and frontmatter checks.

39|3|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/LiorCohen/sdd --skill spec-writing-liorcohen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/LiorCohen/sdd/tree/main/plugin/core/skills/spec-writing
Command: npx skills add https://github.com/LiorCohen/sdd --skill spec-writing-liorcohen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing consistent SPEC.md files is error-prone and tedious. This skill provides templates and built-in validation to enforce structure, metadata, and reliable documentation across tech and product specs.

Core Features & Use Cases

  • Templates for Feature/EPIC/Tech specs to accelerate writing and standardize structure.
  • Frontmatter validation and guidance to ensure required fields and sections are present.
  • Quick-start prompts and examples to kick off new specs quickly.

Quick Start

Create a new SPEC.md by applying the included templates and frontmatter checks.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I create consistent SPEC.md documents for product and tech specs?

To create consistent SPEC.md documents, you can use templates for Feature, EPIC, and Tech specs that automatically enforce structure and metadata validation. This standardizes your documentation and reduces manual formatting errors across the spec lifecycle.

What is the best way to validate frontmatter and required fields in product specs?

Validating frontmatter in product specs requires built-in validation checks that ensure required fields and sections are present. This automated validation process guides structure from acceptance criteria to domain concepts, ensuring consistency and completeness.

Can I use spec templates to standardize acceptance criteria and domain concepts?

Yes, you can use spec templates to standardize acceptance criteria and domain concepts. The templates guide the structure of your SPEC.md files and serialize domain knowledge, ensuring all required sections are consistently documented across both product and tech specs.

Does spec writing automation work for both feature specs and technical documentation?

Spec writing automation works for both feature specs and technical documentation by providing tailored templates for Feature, EPIC, and Tech specs. It applies frontmatter validation and structural guidance uniformly across the entire spec lifecycle.

Why does writing consistent SPEC.md files become error-prone without templates?

Writing consistent SPEC.md files becomes error-prone without templates due to manual formatting, missing required fields, and inconsistent structure. Automated validation and templates eliminate this tedious process by enforcing required sections and frontmatter checks.

How do I quickly start writing a new SPEC.md using quick-start prompts?

To quickly start writing a new SPEC.md, apply the included quick-start prompts and examples to kick off your spec. This immediately applies the correct templates and frontmatter validation to accelerate writing and standardize the document structure.