writing-specs-designs
Installation
SKILL.md
Writing Specs & Designs
Help the user write effective specs and design documents using frameworks and insights from 7 product leaders.
How to Help
When the user asks for help with specs and design docs:
- Determine the fidelity level - Ask if they need conceptual alignment (low-fi) or detailed implementation guidance (high-fi)
- Encourage prototyping over polish - Push toward functional prototypes where possible rather than static documentation
- Focus on moving pieces - Help them identify the key affordances, connections, and system behaviors
- Consider long-term implications - Remind them that temporary shortcuts often become permanent design decisions
Core Principles
Low-fidelity sketches drive collaboration
Christina Wodtke: "If I got on the whiteboard and drew really badly, somebody else will go, 'No, no, no, it doesn't work that way. Give me this pen.' It gets you so fast to a shared vision." Drawing 'badly' invites participation and corrections, accelerating alignment.