Collaborative Brainstorming Skill

An AI-native workflow skill for collaborative brainstorming repositories.

This skill helps teams use AI agents or AI tools to develop shared project thinking without mixing raw notes, proposals, and integrated project documents.

What It Does

The skill defines a repository workflow with clear roles and file boundaries:

• Contributors keep raw thinking in personal/<user>/ and draft proposals in proposals/<user>-*.md.
• Maintainers review proposals and integrate accepted ideas into shared project/ and decisions/ documents.
• AI agents follow the repository contract so they do not overwrite other users' work or edit protected shared documents by accident.

The workflow is useful for early-stage project thinking, product brainstorming, research synthesis, team ideation, and AI-assisted proposal review.

Skill Contents

.
├── SKILL.md
├── references/
│   ├── contributor-workflow.md
│   ├── examples.md
│   ├── maintainer-workflow.md
│   ├── repository-contract.md
│   └── setup.md
├── README.md
├── LICENSE
└── .gitignore

SKILL.md is the entry point. It routes the AI agent to the right reference file:

• setup.md for creating a new collaborative brainstorming repo
• contributor-workflow.md for personal notes and proposal drafting
• maintainer-workflow.md for proposal review and integration
• repository-contract.md for exact rules and front matter
• examples.md for sample prompts and file shapes

Install

Clone this repository directly into your agent's skills directory. The repository root is the skill folder, so SKILL.md should be directly inside the cloned directory.

Common locations:

git clone <repo-url> .agents/skills/collaborative-brainstorming
git clone <repo-url> .claude/skills/collaborative-brainstorming

Use .agents/skills for agent workspaces that load repository-local skills. Use .claude/skills for Claude Code workspaces.

Example Use

Ask your AI agent:

Use the collaborative-brainstorming skill to set up a new brainstorming repository for this project.

Or inside an existing repo:

Use the collaborative-brainstorming skill. I am a contributor and want to turn these notes into a draft proposal.

License

MIT