brainstorming

Guides collaborative requirement exploration and produces approved design specs before implementation.

Updated Aug 15, 2026
One-click install
npx skills add https://github.com/qqlcx5/skills-hub --skill brainstorming-qqlcx5
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/qqlcx5/skills-hub/tree/main/skills/brainstorming
Command: npx skills add https://github.com/qqlcx5/skills-hub --skill brainstorming-qqlcx5

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Jumping straight into code on a vague idea leads to rework, wrong assumptions, and wasted effort. This Skill enforces a structured discovery phase that turns rough ideas into reviewed, approved design documents before any implementation begins. ## Core Features & Use Cases - Guided Clarification: Explores project context, then asks one question at a time to pin down purpose, constraints, and success criteria. - Approach Comparison: Proposes 2-3 implementation approaches with trade-offs and a clear recommendation. - Spec Generation & Review: Writes the approved design to a dated spec file, self-reviews it for placeholders and contradictions, and gates implementation on user approval. - Visual Companion: Optionally serves browser-based mockups and diagrams via a local WebSocket server for visual questions like layout choices. - Use Case: You want to add a subscription billing feature. The Skill interviews you about scope, presents architecture options, writes a design doc to docs/superpowers/specs/, and only after your sign-off hands off to implementation planning. ## Quick Start Ask the agent to brainstorm and design your feature idea before writing any code, then answer its clarifying questions one at a time.

Frequently Asked Questions about brainstorming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a feature idea into a design document with an AI agent?

Invoke the brainstorming flow before any coding: the agent explores your project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, then writes the approved design to a dated spec file under docs/superpowers/specs/.

What is the best way to gather software requirements conversationally?

Ask one question at a time, prefer multiple-choice over open-ended questions, and focus on purpose, constraints, and success criteria. Present design sections incrementally and get approval after each section rather than delivering one large document.

Can I see UI mockups in a browser during requirements brainstorming?

Yes. The visual companion starts a local Node.js server via scripts/start-server.sh that serves HTML mockups to your browser. Your clicks are recorded as JSON events that the agent reads on the next turn.

Does the brainstorming skill work for very small changes?

Yes, the process applies to every project regardless of perceived simplicity. For truly simple changes the design can be just a few sentences, but it must still be presented and approved before implementation begins.

Why does the agent refuse to write code right after brainstorming?

A hard gate blocks all implementation until a design is presented, written to a spec file, self-reviewed, and explicitly approved by you. The only allowed next step is invoking the writing-plans skill to create an implementation plan.

What are the limitations of the visual companion server?

The server auto-exits after 30 minutes of inactivity and must stay running across conversation turns. On Windows or Codex environments it needs foreground mode, and remote setups may require binding to 0.0.0.0 with a custom URL host.