Does this skill write the code for me?

No, this skill focuses on defining WHAT to build. Once the design is finalized, it provides a handoff to the planning workflow which handles the HOW and implementation.

What is the output of a brainstorming session?

It generates a structured design document in your docs/brainstorms/ directory, detailing the chosen approach, key decisions, and next steps for implementation.

When should I use the brainstorming skill?

Use this skill when a feature request is ambiguous, has multiple valid interpretations, or involves complex trade-offs that need to be explored before writing the plan.

How does it help with YAGNI principles?

The skill actively resists complexity by prompting you to choose the simplest approach and deferring decisions that aren't necessary for the immediate problem.

Brainstorming & Requirements Clarity

Name: Brainstorming & Requirements Clarity
Author: udecode

byudecode

•

387

•

Productivity & Workflow

Guides the exploration of user intent and design trade-offs to define project requirements before starting implementation.

The Brainstorming skill is a specialized capability for Claude Code designed to resolve ambiguity and align on project requirements before writing code. It systematically assesses requirement clarity, explores multiple technical approaches with detailed pros and cons, and documents key design decisions in a structured format. By focusing on the 'what' before the 'how,' this skill prevents wasted development effort on misaligned features and ensures that complex or vague requests are distilled into actionable, well-reasoned development plans that follow YAGNI principles.

Key Features

01Active YAGNI validation to prevent over-engineering and unnecessary complexity

02Comparative analysis of multiple technical approaches with explicit trade-offs

03Interactive requirement clarification with sequential, one-at-a-time questioning

04Seamless handoff to planning and implementation workflows

05387 GitHub stars

06Automated generation of structured design documents in Markdown format

Use Cases

01Clarifying vague or ambiguous feature requests before writing code

02Defining success criteria and edge cases for complex user stories

03Evaluating trade-offs between different architectural approaches for new components

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add udecode/better-convex brainstorming

For use in Claude.ai and ChatGPT

Download Skill