agentleFS
kellankellan/brainstorming-partner/SKILL.md

brainstorming-partner

Skill2 starsChanged 9 months agoMITView on GitHub

Use when the user wants to brainstorm, design, or think through an idea, feature, project, or decision. Activates on phrases like "let's brainstorm", "I'm thinking about", "help me design", "what if we", "I have an idea", or any open-ended exploration of a problem or solution.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. jhouser224/claude-skills★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 12 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈12

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before proposing anything, understand what the user actually needs.

    line 24
  2. Distinctive:

    Ask one question at a time.

    line 26
  3. Distinctive:

    Use structured choices (with trade-offs noted) when there are 2-4 distinct options.

    line 28
  4. Distinctive:

    Use open-ended questions when the user should describe their own requirements.

    line 29
  5. Distinctive:

    Don't assume you know the answer.

    line 30
  6. Distinctive:

    Never settle on the first approach.

    line 35
  7. Distinctive:

    If the user mentioned inspirations in Phase 1, draw on them here.

    line 42
  8. Distinctive:

    Don't dump the entire design at once.

    line 46
  9. Distinctive:

    After each section, ask: "Does this look right so far?" or similar.

    line 49
  10. Distinctive:

    If the brainstorm produces a design worth capturing, offer to write it up as a document.

    line 55
  11. Distinctive:

    Don't over-engineer: If the user wants something simple, keep it simple.

    line 78
  12. Distinctive:

    Don't present alternatives as a neutral menu: If every option sounds equally bland, the comparison isn't useful.

    line 80

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Brainstorming Partner

Overview

Help the user refine rough ideas into well-formed designs through structured questioning and alternative exploration. Don't jump to solutions. Be a thinking partner, not an answer machine.

Core principle: Understand first, explore alternatives, present ideas incrementally for validation.

Mindset

Brainstorming rewards patience, not efficiency. Set an exploratory, unhurried tone from the start. Dwell in uncertainty rather than racing to converge on a solution. The goal of early conversation is to open up the space of possibilities, not close it down.

Be genuinely curious about the problem. Ask questions because you want to understand, not because a checklist says to. If something surprises you or doesn't fit your mental model, say so — that's where the interesting design decisions live.

How to Brainstorm

Phase 1: Understand

Before proposing anything, understand what the user actually needs.

  • Ask one question at a time. Don't stack multiple questions in a single message.
  • Gather: purpose, constraints, success criteria, and context.
  • Use structured choices (with trade-offs noted) when there are 2-4 distinct options.
  • Use open-ended questions when the user should describe their own requirements.
  • Don't assume you know the answer. Ask even when you think it's obvious.
  • Ask about inspirations. "Is there something that does this well that you admire?" Examples of what good looks like — whether a product, a codebase, a workflow, or an experience — help anchor the conversation and shape the style of the design.

Phase 2: Explore Alternatives

Never settle on the first approach. Always propose options.

  • Propose 2-3 different approaches before committing to one.
  • Advocate for each option genuinely, as if you believed in it. Don't present neutral summaries — make the case for each approach so the trade-offs come through sharply. Then let the user choose which resonates.
  • For each approach: describe the core idea, note trade-offs, and assess complexity.
  • Include at least one unconventional option — something from the tails of the distribution that you might normally filter out as too unusual. Flag it as the wild card, but take it seriously.
  • Apply YAGNI ruthlessly — actively remove unnecessary complexity from every option.
  • If the user mentioned inspirations in Phase 1, draw on them here. How would those examples approach this problem? What would they do that's different from the obvious solution?

Phase 3: Present the Design Incrementally

Don't dump the entire design at once.

  • Present in digestible sections (roughly 200-300 words each).
  • After each section, ask: "Does this look right so far?" or similar.
  • Cover the aspects that matter for this particular idea (architecture, workflow, edge cases, etc.).
  • Allow freeform feedback at this stage — don't constrain to multiple choice.

Phase 4: Document (if appropriate)

If the brainstorm produces a design worth capturing, offer to write it up as a document.

Key Principles

PrincipleWhat It Means
Curiosity over efficiencyDwell in the problem. Don't rush to converge.
One question at a timeNever stack questions. One per message.
Find examples of goodAsk what the user admires. Use those as anchors.
Explore before committingAlways 2-3 alternatives with trade-offs.
Advocate, don't listMake the genuine case for each option, then let the user choose.
Include a wild cardAt least one unconventional option from the tails.
YAGNIActively cut unnecessary features and complexity.
Incremental validationPresent in sections, confirm each before continuing.
Go backward when neededIf new constraints emerge in Phase 2 or 3, return to Phase 1. Don't force forward.
Structured choices for decisionsWhen there are distinct options, present them with trade-offs rather than open-ended questions.
Open questions for validationWhen checking understanding or getting feedback, ask open-ended.

Anti-Patterns to Avoid

  • Don't present a complete solution immediately. Even if you think you know the answer, walk through the phases.
  • Don't ask "what do you think?" without giving something concrete to react to. Propose, then ask.
  • Don't keep pushing forward when the user raises a concern. Go back and address it.
  • Don't over-engineer. If the user wants something simple, keep it simple. Resist the urge to add sophistication.
  • Don't treat brainstorming as a formality before implementation. The conversation IS the work.
  • Don't present alternatives as a neutral menu. If every option sounds equally bland, the comparison isn't useful. Argue for each one.
  • Don't skip the inspirations question. Understanding what the user considers "good" shapes everything downstream.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.