brainstorming

Guides collaborative design dialogue to turn ideas into approved specs before implementation.

3|Updated Sep 18, 2025
One-click install
npx skills add https://github.com/KingMichaelPark/dotfiles --skill brainstorming-kingmichaelpark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/KingMichaelPark/dotfiles/tree/main/ai/.agents/skills/brainstorming
Command: npx skills add https://github.com/KingMichaelPark/dotfiles --skill brainstorming-kingmichaelpark

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Jumping straight into code without a validated design leads to wasted work, unexamined assumptions, and rework. This Skill enforces a structured brainstorming workflow that explores user intent, requirements, and design trade-offs before any implementation begins. ## Core Features & Use Cases - Structured Design Dialogue: Explores project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and presents the design in sections for incremental approval. - Spec Generation and Review: Writes the approved design to a dated spec file under docs/superpowers/specs/, runs a self-review for placeholders, contradictions, and scope, then gates implementation on user approval. - Visual Companion Server: Includes a Node.js WebSocket server that serves browser-based mockups, diagrams, and clickable option screens for questions that are clearer shown than described. - Use Case: Before building a new feature, use this Skill to refine the idea through dialogue, produce a committed design document, and hand off to an implementation-planning skill only after the user approves the spec. ## Quick Start Ask the agent to brainstorm the design for your next feature before writing any code, and 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 brainstorm a feature design before writing code?

Invoke the brainstorming skill before any implementation work. It explores your project context, asks clarifying questions one at a time, proposes 2-3 approaches with trade-offs, and presents a design for your approval before producing a spec document.

What is the visual companion in the brainstorming workflow?

The visual companion is a browser-based tool that shows mockups, diagrams, and clickable option screens during brainstorming. It is offered only when a question is genuinely clearer shown than described, and it runs as a local Node.js server started with scripts/start-server.sh.

Does the brainstorming skill write any code?

No. The skill enforces a hard gate that blocks all implementation until a design is presented and approved. Its only terminal action is writing the design spec to docs/superpowers/specs/ and then invoking the writing-plans skill.

Can I use the visual companion in remote or containerized environments?

Yes. Start the server with --host 0.0.0.0 and --url-host to bind a non-loopback interface. The session URL includes a secret key that gates HTTP and WebSocket access, so only holders of the full URL can connect.

What happens after the design spec is approved?

After the spec passes self-review and you approve the written document, the skill invokes the writing-plans skill to create a detailed implementation plan. It never invokes implementation skills like frontend-design directly.