write-spec

Write a detailed feature specification from requirements. Use after shaping to create spec.md with goals, user stories, requirements, and technical approach.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/product/write-spec

SKILL.md

Write Spec

Create a comprehensive specification document from gathered requirements.

When to Use

Requirements are gathered in planning/requirements.md
Ready to document the technical specification
Need a clear spec before task breakdown

Workflow

Analyze Inputs
- Read amp-os/specs/[feature]/planning/requirements.md
- Review any visuals in planning/visuals/
- Load relevant standards skills
Search for Reusable Code
- Use finder to locate similar implementations
- Document patterns to reuse
- Note existing components to leverage
Write Specification
- Follow template exactly from spec-template.md
- Save to amp-os/specs/[feature]/spec.md
Generate Architecture Diagram
- Load amp-os-architecture-diagrams skill
- Create system/component diagram with mermaid
Verify Spec Quality
- Load amp-os-spec-verifier skill
- Ensure completeness and feasibility

Important Constraints

Do NOT write actual code in spec.md
Keep sections concise and skimmable
Reference visual assets when available
Follow template structure exactly

Resources

Spec Template

Amp Tools to Use

finder - Find similar implementations
mermaid - Architecture diagrams
oracle - Review spec for completeness