# collaborative-ideation

collaborative-ideation runs the brainstorm step by step: one question at a time, a few approaches, a design in sections, then a committed file under docs/plans/.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 154 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/collaborative-ideation/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/collaborative-ideation

## What it does

The skill holds the conversation before any code. The agent reads what the project already has — files, docs, recent commits — then asks one question per message, multiple choice where that fits, and pins down purpose, constraints and what counts as done.

Once the picture is clear it puts two or three approaches on the table with their trade-offs. The recommended one comes first, reasoning attached. The design arrives in sections of 200-300 words: architecture, components, data flow, error handling, testing. Each section gets a check before moving on, and stepping back to clarify is fine. Unnecessary features get cut with YAGNI.

The agreed design is written to `docs/plans/YYYY-MM-DD-<topic>-design.md` and committed. Then it asks whether to set up implementation, which leans on the `superpowers:using-git-worktrees` and `superpowers:writing-plans` skills; without those two the run stops at the document. The license is proprietary, terms in `LICENSE.txt`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/collaborative-ideation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/collaborative-ideation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/collaborative-ideation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/collaborative-ideation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/collaborative-ideation
```

2. **Manually: put the files in place**
- File: `.github/skills/collaborative-ideation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/collaborative-ideation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/collaborative-ideation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/collaborative-ideation/SKILL.md

## When to use it
- turn a rough idea into a written design
- weigh two or three approaches and their trade-offs
- validate the architecture section by section
- commit the agreed spec to git
- cut unnecessary features with YAGNI

## Example prompts
- Help me think through an export feature — ask me one question at a time before writing anything.
- Before touching code, give me two or three approaches for this refactor and say which one you'd pick.
- Walk me through the design in sections and check each one with me.

## Similar
- [research-ideation](https://affpapa.org/en/nevibecode/skills/awesome-econ-ai-community-research-ideation.md) — skill · 196 installs
- [oma-brainstorm](https://affpapa.org/en/nevibecode/skills/oma-brainstorm.md) — skill · ★ 1472 repo stars
- [spec](https://affpapa.org/en/nevibecode/skills/spec.md) — skill · 5000 installs
- [brainstorm](https://affpapa.org/en/nevibecode/skills/buiducnhat-brainstorm.md) — skill · 628 installs
- [groove-work-spec](https://affpapa.org/en/nevibecode/skills/groove-work-spec.md) — skill · 543 installs
- [brainstorming](https://affpapa.org/en/nevibecode/skills/davidkiss-brainstorming.md) — skill · 164 installs

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
