# 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.

- Skill: `haruhikomotokawa/spec-template` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add haruhikomotokawa/spec-template`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haruhikomotokawa/spec-template/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: HaruhikoMotokawa (https://skillmd.com/u/haruhikomotokawa)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/haruhikomotokawa/spec-template

---


# 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](templates/feature-spec.md) — general-purpose feature specification
- [API Spec](templates/api-spec.md) — 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.