# Spec Templates

> Spec Templates is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Provides reusable markdown templates and outlines for OpenSpec proposals, design docs, ADRs, READMEs, and changelogs.

- Skill name: `spec-templates`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/spec-templates/SKILL.md
- Repository: majiayu000/claude-skill-registry (498 GitHub stars when collected)

## SKILL.md

# Spec & Doc Templates

**Trigger Keywords**: template, outline, spec, proposal, ADR, design doc, README, changelog, release notes, structure

**Agent Integration**: Used by `spec-writer`, `technical-writer`, and planning-focused agents when structuring docs before drafting.

## OpenSpec Proposal Outline
```
# Proposal: <Title>
**Change ID:** `<id>`
**Status:** Draft
**Date:** YYYY-MM-DD
**Author:** <name>

## Executive Summary
## Background
## Goals
## Scope / Non-Goals
## Approach
## Risks & Mitigations
## Validation & Metrics
## Open Questions
```

## Tasks Checklist Outline
```
# Implementation Tasks
**Change ID:** `<id>`
**Status:** Draft|Ready for Implementation

## Overview
<short description>

## Tasks
- [ ] High-level task
  - [ ] Subtask with validation note
```

## Spec Delta Outline
```
# Spec: <Capability Name>
**Capability**: <kebab-case>
**Status**: Draft
**Related**: <optional list>

## Overview
<short description>

## ADDED|MODIFIED|REMOVED Requirements
### Requirement: <Title>
<description>

#### Scenario: <Name>
**Given** ...
**When** ...
**Then** ...
```

## ADR Outline
```
# ADR <ID>: <Title>
Status: Proposed|Accepted|Superseded
Date: YYYY-MM-DD
Context
Decision
Consequences
Alternatives
Open Questions
```

## README Section Ordering (for this plugin)
1. Overview and purpose
2. Installation and setup
3. Quickstart (commands/agents examples)
4. Command reference
5. Agent reference
6. Configuration and hooks
7. Workflows and examples
8. Troubleshooting and support

## Changelog / Release Notes
- Version heading (with date)
- Added / Changed / Fixed / Deprecated / Removed / Security
- Migration or upgrade steps when needed
- Verification checklist or links to tasks/specs

---

Source: https://www.openparable.com/skill/documents/spec-templates (OpenParable). Cite the canonical URL above.