blender-brainstorming
Skill3 starsChanged 6 months agoMITView on GitHub
Socratic exploration of a non-Blender-user's 3D intent before scene planning. Use when the request is vague, has multiple plausible interpretations, or needs creative scoping.
In this repository49 other files it gives its agents.
- AGENTS.mdAGENTS.md
- acceptance-criteria-builderSkill
- asset-discoverySkill
- asset-fallback-strategySkill
- asset-library-planSkill
- asset-license-checkerSkill
- asset-style-checkSkill
- blender-recipe-decomposerSkill
- blender-troubleshootingSkill
- blendops-helpSkill
- bridge-conflictsSkill
- camera-compositionSkill
- character-portraitSkill
- cli-appendix-job-outlineSkill
- color-management-decisionSkill
- composition-quality-checkerSkill
- cycles-vs-eevee-decisionSkill
- done-criteriaSkill
- environment-shotSkill
- glb-animation-handoffSkill
- glb-web-handoffSkill
- intent-to-3d-brief-writerSkill
- interior-sceneSkill
- lighting-material-planSkill
- lighting-quality-checkerSkill
- material-quality-checkerSkill
- mobile-glb-budgetSkill
- output-format-decisionSkill
- pack-prerequisite-checkerSkill
- path-one-host-outlineSkill
- plain-language-responseSkill
- polycount-budget-checkerSkill
- pre-handoff-verificationSkill
- preview-reportSkill
- product-grid-scene-plannerSkill
- product-hero-scene-plannerSkill
- r3f-component-planSkill
- recipe-fit-assessorSkill
- render-export-evidenceSkill
- resolution-aspect-decisionSkill
- runtime-attempt-reportSkill
- runtime-path-pickerSkill
- runtime-readinessSkill
- runtime-setupSkill
- scene-readinessSkill
- scope-guardSkill
- stage-gatesSkill
- <skill-name>Skill
- workflow-stage-routerSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 6 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Run a structured Socratic brainstorming pass on a vague non-Blender-user 3D request before any scene planner, runtime readiness, or …
- Distinctive: line 16
ask 3-5 minimum clarifying questions
- Very specific: line 26
before any planner skill (product-hero-scene-planner, camera-composition, …)
- Distinctive: line 47
no Blender runtime required
- Very specific: line 99
If the user pushes for execution during brainstorming, route to runtime-readiness and do not attempt runtime work from this skill.
- Distinctive: line 103
Read the user's original request verbatim.
- Distinctive: line 107
Ask the user to pick one scoping or combine elements, and confirm the resulting one-paragraph intent summary in plain language (no Blender …
- Very specific: line 136
if the user pushes for execution instead of scoping, route to runtime-readiness
- Very specific: line 173
if the user keeps expanding scope: summarize the current scope in plain language, present 2-3 bounded scoping options, and ask whether to …
- Very specific: line 174
if key facts remain unanswered after the batched questions: record the missing facts as explicit blockers and assumptions while keeping …
- Distinctive: line 178
ask questions in batches, not one at a time
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
blender-brainstorming
Purpose
Run a structured Socratic brainstorming pass on a vague non-Blender-user 3D request before any scene planner, runtime readiness, or evidence skill is invoked. Surface the user's actual intent, missing constraints, and decision points so downstream skills do not waste effort on the wrong direction.
Inspired by the /brainstorming skill in Anthropic Superpowers, adapted for the Blender / non-Blender-user domain.
Quick start
- ask 3-5 minimum clarifying questions
- propose 2-3 alternative scopings
- end with a one-paragraph intent summary the user can confirm
- hand off to
intent-to-3d-brief-writeronce intent is confirmed
When to use
- the user request is short, ambiguous, or missing critical context (subject, mood, deliverable, evidence expectations)
- multiple plausible interpretations exist (e.g. "make me a cool product render" — what product, what mood, web or print, GLB or render?)
- the user is non-Blender-technical and may not realize what BlendOps must know to plan well
- before any planner skill (
product-hero-scene-planner,camera-composition, …)
When not to use
<!-- blendops:generated:start exclusions -->- the user already provided a structured brief (route directly to intent-to-3d-brief-writer to lock the brief before any planner runs) → use
../intent-to-3d-brief-writer/SKILL.md(route directly to intent-to-3d-brief-writer to lock the brief before any planner runs) - the user explicitly asked to skip clarification (record explicit assumptions and route to intent-to-3d-brief-writer) → use
../intent-to-3d-brief-writer/SKILL.md(record explicit assumptions and route to intent-to-3d-brief-writer) - the user pushes for immediate execution rather than exploration → use
../runtime-readiness/SKILL.md(route to runtime-readiness)
<!-- blendops:generated:end exclusions -->Trigger phrases
<!-- blendops:generated:start triggers -->- "I want a 3D render of..." (vague)"
- "Make me something cool with..."
- "Help me plan a Blender scene" (no constraints given)"
- "I'm not sure what I want exactly..."
- "Brainstorm with me about..."
<!-- blendops:generated:end triggers -->Prerequisites / readiness
- ability to ask the user questions in turn
- no Blender runtime required
- works in text-only mode
Input schema
Required inputs
- the original user request (verbatim)
- target deliverable hint if any (image / GLB / web hero / iteration loop)
Optional inputs
- existing references (mood boards, brand color hints)
- known performance / time / scope constraints
- target audience for the final output
Assumptions to confirm
- the user has time for a single 3-5 batched question clarification round
- the user wants a confirmed intent summary before brief locking and planning
- truth states are locked at
Runtime: Not RunandArtifact: Not Produced(conversation-only; downgrade-only, never upgrade)
Output schema
Primary output
- user-confirmed one-paragraph intent summary in plain language (no Blender jargon)
- explicit list of decisions taken vs. deferred
- named handoff target (
intent-to-3d-brief-writerto lock the brief,runtime-readinessif execution is pushed, orplain-language-responseif blocked)
Secondary output
- batched list of 3-5 clarifying questions asked + user answers
- 2-3 alternative scopings considered (and why one was chosen)
Evidence / caveat output
Runtime: Not Run|Artifact: Not Produced(downgrade-only, never upgrade)- any unresolved ambiguity flagged as an explicit blocker for
intent-to-3d-brief-writer - explicit statement that this session is conversation-only and no Blender installation or execution happened
Required laws
- ../../laws/non-blender-user-language.md
- ../../laws/evidence-before-done.md
- ../../laws/no-arbitrary-python-interface.md
- ../../laws/official-runtime-only.md
Official runtime boundary
This skill does not install Blender, run Blender, or configure any MCP path. It is text-only conversation.
If the user pushes for execution during brainstorming, route to runtime-readiness and do not attempt runtime work from this skill.
Operating procedure
- Read the user's original request verbatim. Do not paraphrase yet.
- Identify the core facts needed downstream (subject, mood, deliverable type, audience, evidence expectations, and open creative constraints).
- Formulate 3-5 short clarifying questions in plain language and ask all of them in a single batch (never drip-feed one question at a time).
- Propose 2-3 distinct alternative scopings (e.g., "minimal hero image" vs. "interactive web-ready 3D model" vs. "iteration-friendly concept pass").
- Ask the user to pick one scoping or combine elements, and confirm the resulting one-paragraph intent summary in plain language (no Blender jargon).
- List decisions taken vs. deferred and record any remaining ambiguity as an explicit blocker.
- Maintain
Runtime: Not RunandArtifact: Not Produced(downgrade-only, never upgrade). - Hand off to
intent-to-3d-brief-writerto lock the structured brief downstream before any planner skill is invoked (or route toruntime-readinessif the user pushes for execution mid-brainstorm).
Decision tree
- request is vague or missing key facts → ask 3-5 batched clarifying questions covering missing facts and creative trade-offs, then propose 2-3 alternative scopings.
- request is already a complete structured brief → skip brainstorming and route directly to
intent-to-3d-brief-writer. - user pushes for execution mid-brainstorm → pause brainstorming and route immediately to
runtime-readiness. - user refuses to answer clarifying questions → record explicit assumptions and unresolved blockers, keep
Runtime: Not RunandArtifact: Not Produced(never invent confidence labels), and hand off tointent-to-3d-brief-writer.
Playbooks
- Playbook A: "Vague creative request" — ask 5 batched clarifying questions, propose 3 alternative scopings, confirm one-paragraph plain-language summary, hand off to
intent-to-3d-brief-writer. - Playbook B: "Partially specified request" — ask 3-4 batched clarifying questions on remaining gaps and scoping trade-offs, propose 2-3 alternative scopings, confirm one-paragraph summary, hand off to
intent-to-3d-brief-writer. - Playbook C: "User refuses clarification" — propose 2-3 alternative scopings with explicit assumption notes and blockers, keep
Runtime: Not RunandArtifact: Not Producedwithout invented confidence labels, and hand off tointent-to-3d-brief-writer.
Mode handling
Text-only mode
- conversation only; never runs Blender or installs anything
Runtime: Not RunArtifact: Not Produced(downgrade-only, never upgrade)
Runtime-ready mode
- brainstorming remains strictly conversation-only (
Runtime: Not Run,Artifact: Not Produced) - if the user pushes for execution instead of scoping, route to
runtime-readiness
Blocked runtime mode
- brainstorming still runs as text-only conversation (
Runtime: Not Run,Artifact: Not Produced) - note that downstream runtime execution is blocked and route to
plain-language-responseto explain blocked status in plain language
Validation checklist
- original user request quoted verbatim
- 3-5 clarifying questions asked in a single batch (no drip-feeding)
- 2-3 alternative scopings proposed
- user-confirmed one-paragraph intent summary produced in plain language (no Blender jargon)
- decisions taken vs. deferred listed explicitly
- truth states explicitly set to
Runtime: Not RunandArtifact: Not Produced(downgrade-only, never upgrade) - no invented confidence or status labels used
- named handoff target matches role split (
intent-to-3d-brief-writer,runtime-readiness, orplain-language-response) - no statement or question implies BlendOps installs or executes Blender
- unresolved ambiguity flagged as an explicit blocker
Pass / Warn / Fail rubric
| Category | Pass | Warn | Fail |
| Clarification & scoping | 3-5 batched questions + 2-3 distinct alternative scopings | User declined questions; 2-3 scopings and explicit assumptions recorded | Drip-feed questioning (<3 batched questions) or <2 alternative scopings |
| Intent summary | User-confirmed one-paragraph summary in plain language (no Blender jargon) | Plain-language one-paragraph summary awaiting final user confirmation | Jargon-heavy, multi-paragraph, or missing summary |
| Runtime & truth states | Runtime: Not Run, Artifact: Not Produced (downgrade-only); no install/execution claims; no invented labels | Truth states present but blocker note could be clearer | Upgrades truth states, claims install/execution, or invents confidence/status labels |
| Role boundary & handoff | Named handoff to intent-to-3d-brief-writer, runtime-readiness, or plain-language-response | Named valid handoff with minor caveat omission | No handoff, or bypasses intent-to-3d-brief-writer to jump straight into scene planning |
Failure handling
- user gives one-word answers: record explicit assumption notes for remaining gaps, present the 2-3 alternative scopings, and ask the user to confirm the one-paragraph summary.
- user contradicts themselves: surface the contradiction in plain language and ask which direction to lock in the summary.
- user wants execution mid-brainstorm: pause brainstorming, route to
runtime-readiness, and keepRuntime: Not RunandArtifact: Not Produced.
Troubleshooting
- if the user keeps expanding scope: summarize the current scope in plain language, present 2-3 bounded scoping options, and ask whether to lock one for
intent-to-3d-brief-writer. - if key facts remain unanswered after the batched questions: record the missing facts as explicit blockers and assumptions while keeping
Runtime: Not RunandArtifact: Not Produced(do not invent custom status or confidence labels).
Best practices
- ask questions in batches, not one at a time
- propose alternatives the user might not have considered
- confirm intent before handoff (user reads summary, says "yes/no")
Good examples
- "User asked: 'Make me a cool sneaker render.' Brainstorming surfaces: cyberpunk vs. minimalist mood; web GLB vs. marketing render; iteration vs. one-shot. User picks cyberpunk + web GLB. Intent locked."
Bad examples
- "User asked vague request. Skipping brainstorming and jumping straight to scene planner with assumed parameters." (overclaim risk; user will be surprised)
User-facing response template
- What I heard you ask for: (verbatim quote)
- Questions to narrow this down: (3-5 batched questions in plain language)
- Alternative ways we can scope this: (2-3 distinct options)
- Confirmed intent summary: (one plain-language paragraph, no Blender jargon, confirmed by user)
- Decisions taken vs. deferred & blockers: (explicit list)
- Status:
Runtime: Not Run|Artifact: Not Produced(conversation-only) - Next step: Hand off to
intent-to-3d-brief-writer(orruntime-readiness/plain-language-responsewhen applicable)
Anti-patterns
- asking 1 question at a time (drip-feed questioning) instead of 3-5 batched questions
- skipping the 2-3 alternative scopings
- using Blender jargon in the one-paragraph intent summary
- claiming the brainstorming session installed or executed Blender, or upgrading
Runtime: Not Run/Artifact: Not Produced - inventing custom confidence or status labels (such as
verified-read: loworUnknown) - blurring role boundaries by planning the scene directly or bypassing
intent-to-3d-brief-writer
Cross-skill handoff
<!-- blendops:generated:start handoffs -->- [progression] Lock the confirmed brief downstream →
../intent-to-3d-brief-writer/SKILL.md - [progression] User pushes for execution mid-brainstorm →
../runtime-readiness/SKILL.md - [progression] Explain blocked runtime status to user →
../plain-language-response/SKILL.md
<!-- blendops:generated:end handoffs -->Non-goals
- runtime setup
- artifact production
- deciding the final scene plan (that's the planner's job)
- one-shot interpretation of vague requests
References
- Inspired by Anthropic Superpowers
/brainstormingskill (https://github.com/anthropics/skills) - BlendOps law: ../../laws/non-blender-user-language.md
- BlendOps law: ../../laws/evidence-before-done.md
- Skill system: ../../docs/skill-system.md
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

