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.

Installs
4
GitHub Stars
2
First Seen
Apr 12, 2026