Before you write any code, this skill forces you into a structured conversation to flesh out what you're actually building. It asks questions one at a time (multiple choice when possible), explores 2-3 different approaches with tradeoffs, then presents the design in digestible 200-300 word chunks while checking if you're aligned. Once you validate the design, it writes it to a dated markdown file in docs/plans and can set up a git worktree for implementation. The YAGNI enforcement and incremental validation approach genuinely help avoid the classic mistake of building something half-baked or overengineered because you skipped the thinking phase.

skills.sh installs
562
GitHub stars
33.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add davila7/claude-code-templates --skill brainstorming --agent claude-code

Installs into .claude/skills of the current project.

Files

Brainstorming

You are good at building, and you build what you believe the user wants. That belief is usually thinner than it feels. This skill is for finding out what they actually want, and why, before anything gets built. When you understand the why, you make the hundred unstated decisions the way they would have made them.

First: what do you actually know?

Before replying, ask yourself what you know about what they want, and why.

  • Everything that matters is in the request ("make the icon cornflower blue"): it's a clear task. Do it, say what you did, and stop using this skill.
  • Something non-trivial is missing: start the conversation below.

Before implementing anything, in order:

  1. Lay out the approaches in a message of their own and have the user pick one.
  2. Write the design doc, short or full (see Size the work).
  3. Get the user's approval of that doc.
  4. For a project, hand off to planning (the writing-plans skill if installed, otherwise a numbered implementation plan; using-git-worktrees can isolate the work). For a small change, the approved short design is the plan: build it.

Sponsors

Details

Repository
github.com/davila7/claude-code-templates
Category
Design & UI/UX
First seen
Jun 3, 2026

More from davila7/claude-code-templates

All 618
1aaronontheweb avatarplaywright-blazor-testingaaronontheweb/dotnet-skillsWrite UI tests for Blazor applications (Server or WebAssembly) using Playwright. Covers navigation, interaction, authentication, selectors, and common Blazor-sp560skills.sh installs
2davila7 avatarproduct-strategistdavila7/claude-code-templatesStrategic product leadership toolkit for Head of Product including OKR cascade generation, market analysis, vision setting, and team scaling. Use for strategic 558skills.sh installs
3aj-geddes avatarintegration-testingaj-geddes/useful-ai-promptsDesign and implement integration tests that verify component interactions, API endpoints, database operations, and external service communication. Use for integ557skills.sh installs
4davila7 avatararchitecturedavila7/claude-code-templatesArchitectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing sys555skills.sh installs
5get-convex avatarschema-builderget-convex/agent-skillsDesign and generate Convex database schemas with proper validation, indexes, and relationships. Use when creating schema.ts or modifying table definitions.554skills.sh installs
6lambdatest avatarplaywright-skilllambdatest/agent-skillsGenerates production-grade Playwright automation scripts and E2E tests in TypeScript, JavaScript, Python, Java, or C#. Supports local execution and TestMu AI cl554skills.sh installs