| name | design-spec |
| description | Agent Skill for writing and reviewing durable design specs. Use when the user asks to write, formalize, save, review, or approve a spec, design document, RFC, or implementation-ready proposal. If the direction is still vague or unsettled, use `brainstorming` first before producing the spec. If the direction is already clear and no spec is needed, use `plan`. |
| metadata | {"attribution":"attribution.md"} |
Design Spec
Turn a settled design direction into a durable, reviewed spec artifact that is ready for implementation planning.
This skill captures and validates a chosen direction. It does not explore open trade-offs or invent the design inside the spec workflow. If the direction is still vague, unsettled, or tradeoff-heavy, use brainstorming first. If the direction is already clear and no spec is needed, use plan instead.
Default save path: spec/spec-<slug>-YYYYMMDD.md
User preferences for the spec location override this default.
When To Use
Use this skill when a design needs to become a durable artifact:
- As a continuation of
brainstorming, once the user has confirmed a direction
- When the user already has a clear idea and asks for a written, saved, reviewed, or approved spec
- When a decision is important enough to preserve even if conversation context is lost
Do not use this skill when:
- The direction is still unsettled or meaningful trade-offs have not been explored; use
brainstorming first
- The implementation direction is already clear and no spec is needed; use
plan
Entry Points
