Profile My skills Saved My plugins Edit profile Submit a skill

Spec Template

This skill should be used when creating a new specification document from scratch, when asked for a spec template, when generating boilerplate for a spec, or when onboarding a new feature to SDD. Provides ready-to-use templates for feature and API specifications.

HaruhikoMotokawa Updated
Integrations & APIs

File contents

Spec Templates

Use these templates when creating new specification documents. Template files are in the templates/ directory alongside this SKILL.md.

Available Templates

  • Feature Spec — general-purpose feature specification
  • API Spec — REST/GraphQL API endpoint specification

When to Use Each Template

Template Use When
feature-spec.md Adding a new user-facing feature, changing existing behavior, building a new screen or flow
api-spec.md Adding new endpoints, modifying request/response contracts, deprecating APIs

Quick Start

To create a new feature spec:

  1. Copy templates/feature-spec.md to docs/specs/{feature-name}.md
  2. Replace all {placeholder} values
  3. Delete sections marked [optional] if not applicable
  4. Set status: draft in the frontmatter

For API specs, use templates/api-spec.md instead.

HaruhikoMotokawa/ai-config/tree/main/sdd/skills/spec-template commit 4c13dc9e13

Browse category

Frequently asked questions

npx skillmds@latest add haruhikomotokawa/spec-template