spec-writing
Installation
SKILL.md
Spec Writing
Purpose
Extract requirements, create structured specs, validate requirement quality while authoring, manage spec diffs while evolving a spec, enforce versioning, and produce implementation-ready artifacts.
Use When
- Creating a freeform implementation-ready spec from user input, tickets, or research.
- Consuming a normalized azure-devops handoff JSON to generate a spec from Azure DevOps work item data.
- Emitting an OpenSpec proposal from a spec produced by this skill or a prior session.
- Producing implementation-ready artifacts from ambiguous requests.
Avoid When
- The user only wants code.
- The task has no requirement or spec component.
- The task is validating, scoring, or diffing an existing spec file with no new authoring step.
- The task is pure OpenSpec governance with no spec-authoring step.