brainstorming

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

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

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 misaligned implementations. This Skill enforces a structured discovery process that explores user intent, requirements, and design trade-offs before any code is written. ## 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 in docs/superpowers/specs/, runs a self-review for placeholders and contradictions, and gates implementation behind explicit user approval. - Visual Companion: Optionally serves browser-based mockups, wireframes, and diagrams via a local WebSocket server so users can click to select visual options during brainstorming. - Use Case: Before building a new feature, use this Skill to refine the idea through questions, compare architectural approaches, and produce a committed design document that feeds directly into implementation planning. ## Quick Start Ask the agent to brainstorm the design for your new feature before writing any code.

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 any code is written.

What is the visual companion in brainstorming?

The visual companion is a browser-based tool that displays mockups, wireframes, and diagrams during brainstorming. A local server serves HTML screens you write, and user clicks are recorded as JSON events you read on the next turn.

Does the brainstorming skill work for small changes?

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

How do I start the brainstorming visual companion server?

Run scripts/start-server.sh with --project-dir pointing at your project root. It returns JSON with the URL, screen_dir, and state_dir; on Windows or Codex environments it auto-switches to foreground mode.

What happens after the design is approved?

The design is written to docs/superpowers/specs/ as a dated markdown file, self-reviewed for placeholders and contradictions, then reviewed by the user. After approval, the writing-plans skill is invoked to create the implementation plan.