skills.rest
taylorelley
taylorelleyCOMMUNITY
Explore all skills by this author →
GitHub

brainstorming

Turn ideas into approved design specs through structured collaborative dialogue.

Updated Jun 12, 2026
Search Tags:#planning#brainstorming#collaboration#requirements#websocket#mockups#design spec
One-click install
npx skills add https://github.com/taylorelley/skills --skill brainstorming-taylorelley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brainstorming
Source: https://github.com/taylorelley/skills/tree/main/skills/workflow/brainstorming
Command: npx skills add https://github.com/taylorelley/skills --skill brainstorming-taylorelley

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 disciplined ideation-to-spec workflow 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 & Review: Writes the approved design to a dated spec file, runs a self-review for placeholders, contradictions, and ambiguity, then gates implementation on user approval. - Visual Companion: Optionally serves browser-based mockups, wireframes, and diagrams via a local WebSocket server so users can compare visual options by clicking. - Use Case: Before building a new feature, use this Skill to refine requirements, compare architectural approaches, and produce a committed design document that feeds directly into implementation planning. ## Quick Start Use the brainstorming skill to help me refine my idea for a new feature and turn it into an approved design spec 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 turn a feature idea into a design spec before coding?▼

Use a structured brainstorming workflow: explore the project context, ask clarifying questions one at a time, propose 2-3 approaches with trade-offs, then present the design in sections for approval. The validated design is written to a dated spec file and committed to git.

What is the visual companion for brainstorming mockups?▼

The visual companion is a local browser server that displays HTML mockups, wireframes, and diagrams during brainstorming. You write HTML fragments to a watched directory, the server serves the newest file, 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 projects, but it must still be presented and approved before any implementation action is taken.

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 directory, and state directory. On Windows or Codex environments it auto-switches to foreground mode, which requires a background tool call.

What happens after the design spec is approved?▼

After the user approves the written spec, the workflow invokes the writing-plans skill to create a detailed implementation plan. No other implementation skill is invoked directly from brainstorming.

Why does the brainstorming server stop unexpectedly?▼

The server auto-exits after 30 minutes of inactivity or when its owner process dies. Check the state directory for a server-stopped file, and restart with start-server.sh if server-info is missing.

Related Skills

Explore More Product & Management Skills→
jellyrockjellyrock
37

ramp

Generate a scoped context briefing for JellyRock code subsystems.

Official
Intermediate
moberghrmoberghr
6

planning-and-task-breakdown

Convert approved specs into dependency-ordered task plans with tasks/todo.md artifacts.

Official
Advanced
organvm-i-theoriaorganvm-i-theoria

doc-coauthoring

Guides collaborative document drafting through context gathering, iterative refinement, and reader testing.

Official
Intermediate
kos3nzkos3nz

prototype

Prototype separate LOGIC.md and UI.md branches to validate designs before coding.

Community
Intermediate