brainstorming

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

Updated May 19, 2026
One-click install
npx skills add https://github.com/theGobindSingh/james-portfolio --skill brainstorming-thegobindsingh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/theGobindSingh/james-portfolio/tree/main/.agents/skills/brainstorming
Command: npx skills add https://github.com/theGobindSingh/james-portfolio --skill brainstorming-thegobindsingh

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 features. 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 Documentation & Review: Writes the approved design to a dated spec file, runs a self-review for placeholders, contradictions, and scope issues, then gates implementation on explicit user approval. - Visual Companion: Optionally serves browser-based mockups, wireframes, and diagrams via a local WebSocket server so users can compare visual options and click to select choices. - Use Case: Before building a new feature, use this Skill to refine the idea through dialogue, produce a committed design spec, and only then hand off to an implementation-planning skill. ## Quick Start Ask the agent to brainstorm the design for your new 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 any code is written.

What is the visual companion for design brainstorming?▼

The visual companion is a browser-based tool that shows mockups, wireframes, and diagrams during brainstorming. A local Node.js server serves HTML screens you write, and user clicks are recorded as JSON events for the agent to read.

Does the brainstorming skill work for small or simple projects?▼

Yes, every project goes through the design process regardless of perceived simplicity. The design can be just a few sentences for simple work, 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 a JSON object with the URL, screen directory, and state directory; on Windows or Codex environments it auto-switches to foreground mode.

What happens after the design spec is approved?▼

The approved design is written to a dated spec file under docs/superpowers/specs/, self-reviewed for placeholders and contradictions, and committed to git. The skill then invokes the writing-plans skill to create the implementation plan.