skills.rest
em411
em411COMMUNITY
Explore all skills by this author →
GitHub

brainstorming

Guides collaborative design exploration and produces approved spec documents before implementation.

Updated Jul 15, 2026
Search Tags:#planning#brainstorming#requirements#mockups#user approval#design spec#websocket server
One-click install
npx skills add https://github.com/em411/supercodex --skill brainstorming-em411
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/em411/supercodex/tree/main/skills/brainstorming
Command: npx skills add https://github.com/em411/supercodex --skill brainstorming-em411

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Jumping straight into code without a validated design leads to rework, unexamined assumptions, and misaligned features. This Skill enforces a structured dialogue that turns rough ideas into reviewed, committed design specs before any implementation begins. ## Core Features & Use Cases - Guided Requirements Dialogue: Explores project context, asks one clarifying question at a time, and proposes 2-3 approaches with trade-offs before settling on a design. - Spec Document Workflow: Writes the approved design to a dated spec file, runs a self-review for placeholders, contradictions, and scope, then gates progress on explicit user approval. - Browser-Based Visual Companion: Serves interactive mockups, wireframes, and side-by-side layout comparisons via a local WebSocket server so visual questions get visual answers. - Use Case: Before building a new dashboard feature, use this Skill to clarify requirements, compare layout options in the browser companion, and commit an approved design spec that feeds directly into implementation planning. ## Quick Start Ask the agent to brainstorm the design for your next 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 produces an approved design spec saved to docs/superpowers/specs/.

What is the visual companion in the brainstorming skill?▼

The visual companion is a local browser server that displays mockups, wireframes, and side-by-side layout comparisons during brainstorming. It starts via scripts/start-server.sh and records your clicks as JSON events the agent reads on the 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 trivial work, but it must still be presented and approved before implementation begins.

Can I use the visual companion on Windows or remote environments?▼

Yes. The start script auto-detects Windows shells and Codex environments and switches to foreground mode. For remote or containerized setups, pass --host 0.0.0.0 and --url-host to bind a reachable interface.

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 never invokes implementation skills directly, keeping design and execution as separate gated phases.

Related Skills

Explore More Software Engineering Skills→
MADTeacherMADTeacher

prd-from-context

Generate a Russian PRD from existing dialogue and codebase context.

Community
Advanced
shiftreposhiftrepo

subagent-driven-development

Dispatch fresh subagents per task with two-stage reviews.

Official
Advanced
tiankong0101-bytetiankong0101-byte

superpowers

Enforce a spec-first workflow with brainstorming, TDD, debugging, and branch completion.

Community
Advanced
rmansrmans

scaffold-new-prototype

Create prototype documents with unique PROTO-### IDs and index registration.

Community
Intermediate