When should I use the Brainstorming skill?

Use this skill at the beginning of a task or project before writing code. It is designed to refine rough ideas into structured plans through collaborative dialogue.

Does it create documentation automatically?

Yes, once a design is validated, the skill writes the specification to a dated markdown file in your project's docs/plans directory and commits it to git.

Can I use this for simple bug fixes?

It is best used for creative or developmental tasks. For clear 'mechanical' processes or simple fixes, standard coding workflows are usually more efficient.

How does this skill handle different architectural options?

The skill proposes 2-3 different approaches for your design, highlighting the trade-offs and reasoning for each to help you choose the best path.

How does it help with implementation?

After the design is finalized, it can help set up isolated workspaces using git worktrees and generate a detailed implementation plan.

Collaborative Brainstorming & Design

Name: Collaborative Brainstorming & Design
Author: franroa

byfranroa

0•

Productivity & Workflow

Transforms rough concepts into technical specifications through iterative questioning, trade-off analysis, and incremental validation.

This skill facilitates the discovery and planning phase of software development by turning vague ideas into fully formed designs. It guides Claude to engage in a structured dialogue, asking targeted questions one at a time to uncover project constraints and goals. Instead of jumping straight to code, it proposes multiple architectural approaches, evaluates trade-offs, and documents the final validated design into organized markdown files, ensuring a solid foundation before implementation begins.

Key Features

01Incremental design validation in small, digestible sections

02Iterative questioning to refine requirements and project scope

03Comparative analysis of multiple design approaches with trade-offs

04Seamless transition to implementation planning and git workflows

05Automated documentation of designs to specialized markdown files

060 GitHub stars

Use Cases

01Refining a vague feature request into a comprehensive technical specification

02Collaborative problem-solving during the initial discovery phase of a project

03Evaluating different architectural patterns before starting a new service

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add franroa/chezmoi brainstorming

For use in Claude.ai and ChatGPT

Download Skill