Brainstorming
ed3dai/ed3d-plugins
A skill your agent uses when creating or developing anything, before writing code or implementation plans - refines rough ideas into fully-formed designs through structured Socratic questioning…
Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution.
Install Socratic Brainstorm
$ npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install TheBeardedBearSAS/claude-craft socratic-brainstorm --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/socratic-brainstorm .claude/skills/socratic-brainstorm && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "socratic-brainstorm" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/socratic-brainstorm into .claude/skills/socratic-brainstorm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "socratic-brainstorm", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/socratic-brainstormType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install TheBeardedBearSAS/claude-craft socratic-brainstorm --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/socratic-brainstorm .agents/skills/socratic-brainstorm && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "socratic-brainstorm" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/socratic-brainstorm into .agents/skills/socratic-brainstorm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "socratic-brainstorm", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install TheBeardedBearSAS/claude-craft socratic-brainstorm --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/socratic-brainstorm .cursor/skills/socratic-brainstorm && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "socratic-brainstorm" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/socratic-brainstorm into .cursor/skills/socratic-brainstorm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "socratic-brainstorm", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/TheBeardedBearSAS/claude-craft.git --path .claude/skills/socratic-brainstorm--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install TheBeardedBearSAS/claude-craft socratic-brainstorm --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/socratic-brainstorm .gemini/skills/socratic-brainstorm && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "socratic-brainstorm" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/socratic-brainstorm into .gemini/skills/socratic-brainstorm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "socratic-brainstorm", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install TheBeardedBearSAS/claude-craft socratic-brainstormInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/socratic-brainstorm .github/skills/socratic-brainstorm && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "socratic-brainstorm" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/socratic-brainstorm into .github/skills/socratic-brainstorm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "socratic-brainstorm", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install TheBeardedBearSAS/claude-craft socratic-brainstorm --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/socratic-brainstorm .opencode/skills/socratic-brainstorm && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "socratic-brainstorm" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/socratic-brainstorm into .opencode/skills/socratic-brainstorm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "socratic-brainstorm", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
socratic-brainstorm- GitHub stars
- 107
- Token cost
- ~1.2k tokens
- SKILL.md length
- 513 words
- Files
- 1
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- MIT
At a glance
Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution.
- Works in 5 steps: Questions sur le PROBLÈME → Questions sur les CONTRAINTES → Questions sur les ALTERNATIVES → …
- Requirements are ambiguous
- SKILL.md covers Méthode socratique : 5…, Output attendu, Règles d'or and Anti-patterns, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Socratic Brainstorm is an agent skill from TheBeardedBearSAS/claude-craft. Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution. Use when requirements are ambiguous or before starting a non-trivial feature.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Brainstorming and Tutoring and explanations. The repository describes itself as: Supercharge Claude Code with Expert Knowledge A comprehensive framework for AI-assisted development. Install standardized rules, agents, and commands for your projects across… The licence is MIT.
When your agent uses it
- Requirements are ambiguous
- Before starting a non-trivial feature
Example prompts
- “/socratic-brainstorm”
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 99c1ee3. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.comen.wikipedia.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Socratic Brainstorm loads about 1.2k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 513 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from TheBeardedBearSAS/claude-craft at commit 99c1ee3, republished under its MIT licence (© TheBeardedBearSAS). 513 words, ~1,168 tokens.
Download SKILL.mdSave it as
.claude/skills/socratic-brainstorm/SKILL.md (or your agent's skills folder).- name
- socratic-brainstorm
- description
- Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution. Use when requirements are ambiguous or before starting a non-trivial feature.
- context
- fork
Socratic Brainstorm — Clarifier avant de coder
Skill inspiré de obra/superpowers. Objectif : forcer une phase de questions ciblées avant toute implémentation, pour éviter de coder la mauvaise chose très vite.
Règle d'or : une question coûte 30 secondes, un faux développement coûte 3 jours.
Méthode socratique : 5 familles de questions
À poser avant de toucher au code. Pas toutes à chaque fois — choisir les plus pertinentes selon le contexte.
1. Questions sur le PROBLÈME
- Quel est le vrai problème à résoudre ? (pas la solution supposée)
- Pour qui ? Quel persona / rôle utilisateur ?
- Quel est le coût de ne rien faire ?
- Comment mesurera-t-on le succès ? (KPI, métrique)
- Y a-t-il une solution plus simple qui résout 80% du besoin ?
2. Questions sur les CONTRAINTES
- Contraintes métier : règles légales, compliance, SLA ?
- Contraintes techniques : stack imposée, dépendances, legacy ?
- Contraintes temporelles : deadline, dépendances externes ?
- Contraintes ressources : budget infra, RH, maintenance long terme ?
- Que ne faut-il surtout pas casser ?
3. Questions sur les ALTERNATIVES
- Quelles sont les 3 approches possibles ? (minimum)
- Pourquoi celle-ci plutôt qu'une autre ?
- Qu'a-t-on déjà essayé / envisagé ?
- Existe-t-il une solution off-the-shelf (lib, SaaS) ?
- Peut-on ne rien coder (config, manuel, process) ?
4. Questions sur les HYPOTHÈSES
- Qu'est-ce qu'on suppose sans avoir vérifié ?
- Quel est le volume / trafic attendu ?
- Quel est le pattern d'usage réel (95% cas / 5% edge cases) ?
- Quels acteurs externes impliqués ? (API tierces, équipes, utilisateurs)
- Que se passe-t-il si cette hypothèse est fausse ?
5. Questions sur les CONSÉQUENCES
- Qu'est-ce qui change pour l'utilisateur final ?
- Impact sur les autres features / modules ?
- Coûts d'exploitation (infra, monitoring, support) ?
- Comment rollback si ça tourne mal ?
- Comment évolue cette solution dans 1 an, 3 ans ?
Output attendu
Après la phase brainstorm, produire une page (max) avec :
- Problème reformulé en 1-2 phrases
- Contraintes principales (5 bullets max)
- Option retenue + 2 alternatives rejetées avec raison
- Hypothèses clés à valider en début d'implémentation
- Risques identifiés + mitigations
Show full SKILL.md (205 more words)Show less
Règles d'or
NE PAS sauter cette phase si :
- La demande initiale contient le mot "peut-être", "probablement", "je pense"
- Le demandeur n'est pas un utilisateur final
- Multiple solutions semblent possibles à première vue
- La feature touche du code legacy ou un domaine complexe
SAUTER cette phase si :
- Bug obvious avec un seul fix possible
- Typo / formatage / doc
- Tâche < 10 min avec périmètre trivial
Anti-patterns
| Anti-pattern | Solution |
|---|---|
| Brainstorm infini sans décision | Timebox 30 min max |
| Questions rhétoriques (réponse évidente) | Questions ouvertes et utiles |
| Répondre soi-même sans demander | Vraiment poser les questions au demandeur |
| Skip brainstorm "parce que c'est urgent" | L'urgence coûte 10x le brainstorm évité |
| Noter les réponses dans sa tête | Écrire = visible, revisitable, versionable |
Intégration Claude Craft
/workflow:analyze— phase d'analyse BMAD commence par ce skill/workflow:plan— PRD doit répondre aux 5 familles de questions- Agent
@product-owner— peut conduire le brainstorm avec le demandeur - Skill
atomic-tasks— l'output du brainstorm se découpe en tâches atomiques - Skill
architect— vient APRÈS le brainstorm pour les features architecturales
Variante rapide : "5 Whys"
Pour bugs ou causes racines, utiliser les 5 Whys de Toyota :
Bug: "Le paiement échoue"
Why 1: Pourquoi ? → L'API retourne 500
Why 2: Pourquoi ? → Timeout DB
Why 3: Pourquoi ? → Requête sans index
Why 4: Pourquoi ? → Colonne ajoutée sans migration d'index
Why 5: Pourquoi ? → Pas de checklist PR pour les migrationsCause racine : absence de checklist, pas le 500.
Ressources
- obra/superpowers
- Socratic Method - Wikipedia
- 5 Whys - Toyota
- Skill
atomic-tasks,architect
Date de dernière mise à jour : 2026-04-15 Version : 1.0.0
© TheBeardedBearSAS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/skills/socratic-brainstorm of TheBeardedBearSAS/claude-craft.
Open the folder on GitHubat commit 99c1ee3
Compare with similar skills
Socratic Brainstorm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Socratic Brainstorm this skillTheBeardedBearSAS/claude-craft | 107 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Brainstorminged3dai/ed3d-plugins | 250 | 1 repos | ~4.3k | Automated safety check: Pass | None | |
| Brainstormandrew-yangy/gru-ai | 155 | — | ~3.2k | Automated safety check: Pass | MIT | |
| Gsd Exploreopen-gsd/gsd-core | 10k | 2 repos | ~176 | Automated safety check: Notes | MIT | |
| BrainstormingxenitV1/Antigravity-Workflows | 130 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Yao Bayesian Skillyaojingang/yao-open-skills | 1.3k | — | ~956 | Automated safety check: Pass | MIT |
Similar skills
Brainstorm
andrew-yangy/gru-ai
Structured brainstorm — from quick Socratic refinement to full C-suite strategy sessions.
Gsd Explore
open-gsd/gsd-core
Socratic ideation and idea routing — think through ideas before committing to plans
Brainstorming
xenitV1/Antigravity-Workflows
Socratic questioning protocol + user communication. An agent skill from xenitV1/Antigravity-Workflows.
Yao Bayesian Skill
yaojingang/yao-open-skills
Convert uncertain real-world choices into an auditable Bayesian evidence-to-action report with priors, evidence grading, posterior update, action thresholds, sensitivity checks, multi-turn decision…
Yao Gametheory Skill
yaojingang/yao-open-skills
Route CEO-facing competition, negotiation, channel, pricing, platform, M&A, financing, competitor-response, alliance, and regulator problems through an applied game-theory framework router when…
More from TheBeardedBearSAS/claude-craft
All 12 skills in this repoArchitect
TheBeardedBearSAS/claude-craft
Phase d'architecture systématique AVANT le code (TDD). An agent skill from TheBeardedBearSAS/claude-craft.
Async
TheBeardedBearSAS/claude-craft
Architecture async-first avec messaging et queues (Symfony Messenger, Laravel Queue, Ecotone).
Atomic Tasks
TheBeardedBearSAS/claude-craft
Pattern GSD (Get Shit Done) - découper en tâches atomiques avec contextes subagent frais pour combattre le context rot.
Cqrs
TheBeardedBearSAS/claude-craft
CQRS - Command Query Responsibility Segregation. An agent skill from TheBeardedBearSAS/claude-craft.
Design Md Convention
TheBeardedBearSAS/claude-craft
Convention DESIGN.md pour design systems AI-friendly. An agent skill from TheBeardedBearSAS/claude-craft.
Docker Hadolint
TheBeardedBearSAS/claude-craft
Docker & Hadolint validation (2026). An agent skill from TheBeardedBearSAS/claude-craft.
Related
Categories
Questions about Socratic Brainstorm
What does Socratic Brainstorm do?
Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution. Socratic Brainstorm is an agent skill from TheBeardedBearSAS/claude-craft. Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution.
When should I use Socratic Brainstorm?
Socratic Brainstorm fits situations like: requirements are ambiguous; before starting a non-trivial feature.
How do I install Socratic Brainstorm in Claude Code?
Run `npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a claude-code`. Or copy the skill folder (.claude/skills/socratic-brainstorm in TheBeardedBearSAS/claude-craft) into .claude/skills/socratic-brainstorm in your project. Claude Code loads it when a task matches its description.
How do I install Socratic Brainstorm in Codex?
Run `npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a codex`. Or copy the skill folder (.claude/skills/socratic-brainstorm in TheBeardedBearSAS/claude-craft) into .agents/skills/socratic-brainstorm in your project. Codex loads it when a task matches its description.
Can I use Socratic Brainstorm in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TheBeardedBearSAS/claude-craft --skill socratic-brainstorm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/socratic-brainstorm, .gemini/skills/socratic-brainstorm, .github/skills/socratic-brainstorm and .opencode/skills/socratic-brainstorm in your project.
What does Socratic Brainstorm need to run?
SKILL.md names no scripts, command-line tools or credentials: Socratic Brainstorm is instructions for the agent only.
Does Socratic Brainstorm access the network?
SKILL.md names 2 domains. As links in the text: github.com and en.wikipedia.org. This is read from the text; nothing was executed.
Is Socratic Brainstorm safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Socratic Brainstorm use?
Socratic Brainstorm is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Socratic Brainstorm use?
About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Socratic Brainstorm?
Skills that share tags, products or a category with Socratic Brainstorm: Brainstorming (ed3dai/ed3d-plugins, 250 stars), Brainstorm (andrew-yangy/gru-ai, 155 stars), Gsd Explore (open-gsd/gsd-core, 10k stars) and Brainstorming (xenitV1/Antigravity-Workflows, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Socratic Brainstorm?
TheBeardedBearSAS (a GitHub organization) maintains it in TheBeardedBearSAS/claude-craft, which has 107 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 14, 2026.
Source: TheBeardedBearSAS/claude-craft on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.