brainstorming

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

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

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 brainstorming workflow that explores 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, runs a self-review for placeholders, contradictions, and scope issues, then gates implementation on user approval. - Browser-Based Visual Companion: Serves interactive HTML mockups, wireframes, and side-by-side comparisons 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 decompose the idea, compare architectural approaches, present mockups in the browser, and produce a committed design document ready for implementation planning. ## 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 writing a spec document.

What is the visual companion for brainstorming mockups?

The visual companion is a browser-based tool that serves HTML mockups, wireframes, and side-by-side comparisons through a local server. You click options in the browser, and your selections are recorded as events the agent reads on its next turn.

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; mockups persist under .superpowers/brainstorm/ in your project.

What happens after the design spec is approved?

After you approve the written spec, the skill invokes the writing-plans skill to create a detailed implementation plan. It does not invoke any implementation skill directly, keeping design and execution as separate gated phases.