brainstorming

Guide teams from vague ideas to validated design documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Guides teams to transform vague ideas into validated designs by guiding context discovery, questions, and design decisions before implementation.

Core Features & Use Cases

  • Structured brainstorming workflow: explore project context, ask clarifying questions, propose 2-3 approaches with trade-offs, and obtain user approval.
  • Design docs generation and handoff: writes specs to docs/specs/YYYY-MM-DD-<topic>-design.md and commits for review.
  • Optional visuals support: leverages a visual companion to show mockups and diagrams when needed.
  • Collaborative review loop: performs spec self-review and user review gate before implementation.

Quick Start

Start by describing your idea and project goals, then follow the prompts to refine requirements and approve a design before implementation.

Frequently Asked Questions about brainstorming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn vague ideas into validated design documents?

To turn vague ideas into validated design documents, this Skill guides context discovery and asks clarifying questions one at a time. It proposes 2-3 approaches with trade-offs, obtains user approval, and generates a design document for engineering handoff.

What is the best way to structure team brainstorming before implementation?

The best way to structure team brainstorming before implementation is using a scripted workflow that tracks feedback. It performs a spec self-review and user review gate, ensuring a clean handoff to engineering by committing validated design specifications.

How does the design specification workflow handle visual mockups?

The design specification workflow handles visual mockups through an optional visual companion. It leverages this companion to show mockups and diagrams when needed during the collaborative review loop, supporting comprehensive visual exploration of the proposed approaches.

Can I generate design docs and save them directly to project specifications?

Yes, you can generate design docs and save them directly to project specifications. The Skill writes specs to docs/specs/YYYY-MM-DD-<topic>-design.md and commits them for review, creating reusable artifacts that ensure clean engineering handoff.

Does the ideation process require any external dependencies or libraries?

No, the ideation process does not require any external dependencies or libraries. It operates independently through scripts, guiding context discovery and design decisions without needing additional framework installations or platform integrations to function.