collaborative-ideation — Claude Code skill: from idea to design
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/.
LicenseRef-Proprietary 154 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a claude-codeWhat collaborative-ideation 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.
What it helps with
- 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 for the agent
- 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.
How to install collaborative-ideation
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a claude-code2Manually: put the files in place
~/.claude/skills/collaborative-ideation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/collaborative-ideation/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a codex2Manually: put the files in place
.agents/skills/collaborative-ideation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a cursor2Manually: put the files in place
.cursor/skills/collaborative-ideation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/collaborative-ideation2Manually: put the files in place
.github/skills/collaborative-ideation/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/collaborative-ideationManually: put the files in place
.devin/skills/collaborative-ideation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about collaborative-ideation
How do I install collaborative-ideation in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill collaborative-ideation -a claude-code. The skill lands at ~/.claude/skills/collaborative-ideation/SKILL.md.
What does collaborative-ideation do?
It takes an idea through questions and alternative approaches, validates the design in sections, then writes the result to a file and commits it.
What do I need for the implementation stage?
The superpowers:using-git-worktrees and superpowers:writing-plans skills: the first sets up an isolated workspace, the second writes a detailed plan.