design
Gather requirements and create a specification for a new feature or system. Use when the user wants to design, spec out, or plan requirements for something they want to build.
When & Why to Use This Skill
The Design skill for Claude is a powerful requirement engineering tool that transforms high-level ideas into detailed, actionable technical specifications. By utilizing an interactive questioning framework, it identifies potential edge cases, system constraints, and integration requirements, ultimately generating a standardized spec.md file to bridge the gap between conceptualization and implementation.
Use Cases
- Feature Scoping: Define the boundaries, user-facing behavior, and technical requirements for a new software feature before writing any code.
- System Architecture Planning: Outline how a new system or module will integrate with existing infrastructure, including performance and security constraints.
- Requirement Elicitation: Use the interactive 'AskUserQuestion' tool to resolve ambiguities in project briefs and uncover hidden technical dependencies.
- Standardized Documentation: Automatically generate structured spec.md files that serve as a single source of truth for developers and stakeholders.
| name | design |
|---|---|
| description | Gather requirements and create a specification for a new feature or system. Use when the user wants to design, spec out, or plan requirements for something they want to build. |
Design Skill
Help the user flesh out their idea into a complete specification.
Process
- Listen to the user's problem or idea description
- Ask clarifying questions using the
AskUserQuestiontool when there are genuine ambiguities or gaps that would affect implementation:- Unclear scope or boundaries
- Missing edge cases that could cause issues
- Integration points with existing systems
- Constraints (performance, security, compatibility)
- User-facing behavior that needs definition
- Stop asking when you have enough to write a useful spec - don't over-question
- Generate a spec.md file using the template in spec-template.md
Guidelines
- Always use the
AskUserQuestiontool for clarifying questions - this provides a better UX with selectable options - You can ask up to 4 questions at once, each with 2-4 options
- Write concise option labels (1-5 words) with helpful descriptions
- Use
multiSelect: truewhen choices aren't mutually exclusive - Users can always select "Other" to provide custom input
- Group related questions in a single tool call when possible
- Accept "Other" responses gracefully and follow up if needed
- Use your judgment - simple features need fewer questions
- Explore the codebase if needed to understand existing patterns and constraints
- The spec should be actionable for implementation planning
Output
Save the final specification to spec.md in the current working directory (or project root if appropriate).
After creating the spec, suggest the user review it and then use plan mode to create an implementation plan.