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.
Installs
7
First Seen
Oct 12, 2026