Spec Writer

Turns a vague feature request into a structured spec, technical plan, and task breakdown — ready for any coding agent to implement without guessing.

Overview

AI coding agents don't fail because the model is weak. They fail because the instructions are ambiguous. This skill closes that gap before the agent starts.

Given any feature description — a sentence, a ticket, a PRD fragment, a rough idea — spec-writer produces three deliverables in a single output:

1. A Spec — functional, technology-agnostic. What the feature does, who uses it, what must be true, what can go wrong, and binary acceptance criteria in Given/When/Then format.
2. A Plan — technical and concrete. Architecture decisions, data model changes, API contracts, testing strategy, security constraints.
3. A Task breakdown — ordered, self-contained tasks. Each completable in a single agent session. Each with its own acceptance criteria.

The key methodology: generate first, flag assumptions inline. Instead of asking clarifying questions before drafting, the skill produces a complete output and marks every decision made without user input as [ASSUMPTION: ...] — impact-rated, with guidance on when to correct it.