write-a-spec
Installation
SKILL.md
Write a Spec
Create a durable planning document for a significant change. This skill covers both:
- feature specs / PRDs
- refactor RFCs / change plans
1. Pick the mode
Decide which mode fits the request:
- Feature spec when the user is planning new product behavior, a major feature, or a product requirement
- Refactor RFC when the user is restructuring an existing system, improving architecture, or breaking a refactor into safe incremental steps
If the request is ambiguous, ask one short question to resolve the mode.
2. Gather the problem space
Start with a detailed description from the user, then explore the repo to verify assumptions and understand the current state.