Purpose
State the skill's narrow job in one or two sentences. Keep it composable; do not make this skill own unrelated planning, runtime, evidence, and handoff work at the same time.
Quick start
- Confirm the user's goal and current evidence state.
- Select the correct runtime stack posture, if runtime is relevant.
- Follow the workflow below.
- Return the output contract with explicit evidence/caveat status.
When to use
Use this skill when:
- <trigger condition 1>
- <trigger condition 2>
- <trigger condition 3>
When not to use
Do not use this skill when:
- The request belongs to a narrower existing skill.
- The user asks for runtime execution but readiness has not been checked.
- The task would require claiming preview/render/GLB artifacts without evidence.
- The task would promote unofficial bridge setup as an official path.
Trigger phrases
Prerequisites / readiness
- Current BlendOps status is known: Draft v0 unless a newer release-readiness doc says otherwise.
- Runtime state is one of:
Not Run, Attempted, Produced, Verified, Failed, or Blocked / Not Run.
- If runtime is needed, identify the intended stack before execution.
- If artifacts are discussed, evidence source and output paths must be available or marked missing.
Input schema
Required inputs
| Input |
Why it is required |
| User goal |
Defines scope and prevents overwork. |
| Current runtime/artifact state |
Prevents unsupported success claims. |
| Relevant target surface or workflow |
Determines handoff and constraints. |
Optional inputs
| Input |
Use |
| Runtime stack |
Needed only when runtime work is in scope. |
| Output target |
Helps shape render/export/evidence requirements. |
| Existing evidence links |
Lets the skill verify rather than speculate. |
Assumptions to confirm
- Runtime install is separate from skill install.
- No Blender mutation/render/export occurs unless explicitly requested and readiness passes.
- Missing evidence means the output remains conservative.
Output schema
Primary output
Secondary output
- next recommended skill/doc
- blockers or caveats
- user-facing status line
Evidence / caveat output
Always include:
Runtime status: Not Run | Attempted | Produced | Verified | Failed | Blocked / Not Run
Artifact status: Not Run | Not Produced | Produced | Verified | Failed
Evidence used: <links, paths, logs, or "none">
Limitations: <known gaps>
Required laws
../../laws/official-runtime-only.md
../../laws/evidence-before-done.md
../../laws/non-blender-user-language.md
../../laws/no-arbitrary-python-interface.md
Official runtime boundary
BlendOps runtime guidance uses 2 MCP execution paths plus a CLI fallback appendix (replaces older 3-stack and 4-route drafts — see ../../docs/runtime-stack-strategy.md for the corrected attribution history):
- Path 1 — Official Blender Lab MCP (Lab add-on + Lab server installed in Blender 5.1+, hosted from either (a) Anthropic Blender Connector in Claude Desktop, or (b) any other MCP client configured manually). Anthropic Connector is not standalone — Anthropic's tutorial step 2 tells you to install the Lab add-on inside Blender.
- Path 2 — Community
ahujasid/blender-mcp (different addon.py + server via uvx blender-mcp, mature 21K+ stars third-party, Blender 3.0+).
- CLI fallback (appendix) — direct
blender --background --python, no MCP. Documented upstream as a first-class Blender CLI surface (stable across LTS releases); no in-repo evidence file yet.
Blender 5.1+ floor applies to all of Path 1 (whichever host). Single-bridge constraint: Blender accepts one MCP bridge session per Blender instance.
This skill must not install Blender, run Blender, configure a runtime bridge, mutate a scene, render, export GLB, or claim artifacts unless the user explicitly requested that work and evidence exists.
Runtime route requirements
| Path |
Requirement before use |
| Path 1 (Blender-side, always required) |
Blender 5.1+ + Lab MCP add-on installed in Blender + Lab MCP server (.mcpb bundle or source) reachable. |
| Path 1, host (a) Anthropic Connector |
Connector enabled in Claude Desktop → Customize → Connectors; read-only request first. |
| Path 1, host (b) manual MCP client |
Lab MCP server registered in client's mcpServers JSON or equivalent UI; read-only request first. |
Path 2 (community ahujasid/blender-mcp) |
uvx blender-mcp registered in client config + addon.py installed/enabled in Blender 3.0+; read ../../docs/unofficial-runtime-bridges.md first; explicit user opt-in for execute_blender_code (no sandbox). |
| CLI fallback (appendix) |
Exact Blender executable/CLI command, input/script, output paths, logs, validation evidence; note that BlendOps has no in-repo evidence file yet (the CLI itself is upstream-stable). |
Operating procedure
- Identify user goal and current phase.
- Check whether this skill is the narrowest applicable skill.
- Confirm required inputs and assumptions.
- Apply relevant laws.
- Execute the workflow steps for this skill.
- Produce the output contract.
- Hand off to the next skill or doc when needed.
Decision tree
Need help choosing next step?
→ blendops-help
Need runtime readiness?
→ official-runtime-readiness-checker
Need scene plan?
→ product-hero-scene-planner and domain planners
Need render/export proof?
→ render-export-evidence
Need GLB/web handoff wording?
→ glb-web-handoff
Need final non-Blender-user summary?
→ non-blender-user-response-writer
Playbooks
Playbook A: Text-only mode
- Keep runtime status
Not Run.
- Produce planning/checklist output only.
- State that preview/render/GLB artifacts are
Not Produced unless evidence exists.
Playbook B: Runtime-ready mode
- Verify runtime stack and preflight evidence.
- Record exact actions, tools, inputs, output paths, and limitations.
- Do not upgrade status beyond the evidence.
Playbook C: Blocked mode
- Identify blocker.
- Keep runtime/artifact status conservative.
- Recommend the next safe readiness or planning step.
Mode handling
Text-only mode
Use when Blender is not available or not requested. Do not imply runtime execution.
Runtime-ready mode
Use only when the user explicitly requests runtime work and readiness is documented.
Blocked runtime mode
Use when requirements are missing. Report blockers and next safe action.
Validation checklist
Pass / Warn / Fail rubric
| Verdict |
Criteria |
| Pass |
Output satisfies scope, evidence state is explicit, and no overclaim appears. |
| Warn |
Output is useful but has missing inputs, partial evidence, or scoped uncertainty. |
| Fail |
Output claims unsupported runtime/artifact success, ignores laws, or routes to an unsupported path. |
Failure handling
- If evidence is missing, downgrade status instead of guessing.
- If runtime readiness is unknown, hand off to readiness skill.
- If a user asks for unsupported direct official MCP usage, mark it future research/unverified.
- If an unofficial bridge appears, keep it optional/local and outside release evidence.
Troubleshooting
| Problem |
Response |
| User wants “done” without evidence |
Explain missing evidence and use Not Run / Not Produced. |
| User conflates skill install with runtime install |
Separate skill install, runtime setup, and eval evidence. |
| User asks for marketplace/package claim |
Keep as future until verified. |
Best practices
- Prefer operational checklists over essays.
- Keep examples short and evidence-bound.
- Link docs instead of copying large reference content.
- Use precise status words.
- Hand off instead of expanding scope.
Good examples
- “Runtime status: Not Run. Artifact status: Not Produced. Next safe action: run runtime readiness checklist for Path 1, host (a) Anthropic Blender Connector.”
- “Produced evidence exists at
<path>, but validation is incomplete; status remains Produced, not Verified.”
Bad examples
- “Everything is ready” without evidence.
- “GLB produced” without file path and validation notes.
- “Use official direct MCP from Claude Code” as a supported route.
User-facing response template
Status: <Pass/Warn/Fail or scoped status>
Runtime: <state>
Artifacts: <state>
Evidence: <paths/links/logs or none>
Next safe action: <skill/doc/action>
Limitations: <gaps>
Anti-patterns
- Turning a planning skill into a runtime executor.
- Treating third-party bridge setup as official.
- Treating read-only connector access as full runtime eval.
- Treating install success as artifact success.
Cross-skill handoff
- Runtime readiness →
../official-runtime-readiness-checker/SKILL.md
- Scene planning →
../product-hero-scene-planner/SKILL.md
- Render/export evidence →
../render-export-evidence/SKILL.md
- GLB handoff →
../glb-web-handoff/SKILL.md
- Final response →
../non-blender-user-response-writer/SKILL.md
Non-goals
- Install Blender.
- Run Blender.
- Configure connector/MCP/CLI runtime.
- Create scene data.
- Render or export GLB.
- Claim marketplace/package availability.
References
../../docs/skill-system.md
../../docs/runtime-stack-strategy.md
../../docs/evals/runtime-availability-checklist.md
../../docs/evals/official-runtime-verification-criteria.md
../../docs/distribution-strategy.md
1---2name: template3description: <!--4---56<!--7TEMPLATE FILE — DO NOT UPLOAD OR ZIP AS-IS.89Before using:101. Replace EVERY `<placeholder>` (name, description, headings, examples).112. Confirm `name` matches your folder slug exactly.123. Confirm `description` is ≤200 chars and triggers the right use cases.134. Delete this HTML comment block.1415This file is excluded from `npm run skills:export` and from docs:check16frontmatter validation, so it can keep placeholder values safely in-repo.17-->1819# <skill-name>2021## Purpose2223State the skill's narrow job in one or two sentences. Keep it composable; do not make this skill own unrelated planning, runtime, evidence, and handoff work at the same time.2425## Quick start26271. Confirm the user's goal and current evidence state.282. Select the correct runtime stack posture, if runtime is relevant.293. Follow the workflow below.304. Return the output contract with explicit evidence/caveat status.3132## When to use3334Use this skill when:3536- <trigger condition 1>37- <trigger condition 2>38- <trigger condition 3>3940## When not to use4142Do not use this skill when:4344- The request belongs to a narrower existing skill.45- The user asks for runtime execution but readiness has not been checked.46- The task would require claiming preview/render/GLB artifacts without evidence.47- The task would promote unofficial bridge setup as an official path.4849## Trigger phrases5051- “<example trigger>”52- “<example trigger>”53- “<example trigger>”5455## Prerequisites / readiness5657- Current BlendOps status is known: Draft v0 unless a newer release-readiness doc says otherwise.58- Runtime state is one of: `Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`, or `Blocked / Not Run`.59- If runtime is needed, identify the intended stack before execution.60- If artifacts are discussed, evidence source and output paths must be available or marked missing.6162## Input schema6364### Required inputs6566| Input | Why it is required |67|---|---|68| User goal | Defines scope and prevents overwork. |69| Current runtime/artifact state | Prevents unsupported success claims. |70| Relevant target surface or workflow | Determines handoff and constraints. |7172### Optional inputs7374| Input | Use |75|---|---|76| Runtime stack | Needed only when runtime work is in scope. |77| Output target | Helps shape render/export/evidence requirements. |78| Existing evidence links | Lets the skill verify rather than speculate. |7980### Assumptions to confirm8182- Runtime install is separate from skill install.83- No Blender mutation/render/export occurs unless explicitly requested and readiness passes.84- Missing evidence means the output remains conservative.8586## Output schema8788### Primary output8990- <main deliverable>9192### Secondary output9394- next recommended skill/doc95- blockers or caveats96- user-facing status line9798### Evidence / caveat output99100Always include:101102```txt103Runtime status: Not Run | Attempted | Produced | Verified | Failed | Blocked / Not Run104Artifact status: Not Run | Not Produced | Produced | Verified | Failed105Evidence used: <links, paths, logs, or "none">106Limitations: <known gaps>107```108109## Required laws110111- `../../laws/official-runtime-only.md`112- `../../laws/evidence-before-done.md`113- `../../laws/non-blender-user-language.md`114- `../../laws/no-arbitrary-python-interface.md`115116## Official runtime boundary117118BlendOps runtime guidance uses **2 MCP execution paths plus a CLI fallback appendix** (replaces older 3-stack and 4-route drafts — see `../../docs/runtime-stack-strategy.md` for the corrected attribution history):1191201. **Path 1 — Official Blender Lab MCP** (Lab add-on + Lab server installed in Blender 5.1+, hosted from either (a) Anthropic Blender Connector in Claude Desktop, or (b) any other MCP client configured manually). Anthropic Connector is **not** standalone — Anthropic's tutorial step 2 tells you to install the Lab add-on inside Blender.1212. **Path 2 — Community `ahujasid/blender-mcp`** (different `addon.py` + server via `uvx blender-mcp`, mature 21K+ stars third-party, Blender 3.0+).1223. **CLI fallback (appendix)** — direct `blender --background --python`, no MCP. **Documented upstream** as a first-class Blender CLI surface (stable across LTS releases); no in-repo evidence file yet.123124Blender 5.1+ floor applies to all of Path 1 (whichever host). Single-bridge constraint: Blender accepts one MCP bridge session per Blender instance.125126This skill must not install Blender, run Blender, configure a runtime bridge, mutate a scene, render, export GLB, or claim artifacts unless the user explicitly requested that work and evidence exists.127128## Runtime route requirements129130| Path | Requirement before use |131|---|---|132| Path 1 (Blender-side, always required) | Blender 5.1+ + Lab MCP add-on installed in Blender + Lab MCP server (`.mcpb` bundle or source) reachable. |133| Path 1, host (a) Anthropic Connector | Connector enabled in Claude Desktop → Customize → Connectors; read-only request first. |134| Path 1, host (b) manual MCP client | Lab MCP server registered in client's `mcpServers` JSON or equivalent UI; read-only request first. |135| Path 2 (community `ahujasid/blender-mcp`) | `uvx blender-mcp` registered in client config + `addon.py` installed/enabled in Blender 3.0+; read `../../docs/unofficial-runtime-bridges.md` first; explicit user opt-in for `execute_blender_code` (no sandbox). |136| CLI fallback (appendix) | Exact Blender executable/CLI command, input/script, output paths, logs, validation evidence; note that BlendOps has no in-repo evidence file yet (the CLI itself is upstream-stable). |137138## Operating procedure1391401. Identify user goal and current phase.1412. Check whether this skill is the narrowest applicable skill.1423. Confirm required inputs and assumptions.1434. Apply relevant laws.1445. Execute the workflow steps for this skill.1456. Produce the output contract.1467. Hand off to the next skill or doc when needed.147148## Decision tree149150```txt151Need help choosing next step?152 → blendops-help153Need runtime readiness?154 → official-runtime-readiness-checker155Need scene plan?156 → product-hero-scene-planner and domain planners157Need render/export proof?158 → render-export-evidence159Need GLB/web handoff wording?160 → glb-web-handoff161Need final non-Blender-user summary?162 → non-blender-user-response-writer163```164165## Playbooks166167### Playbook A: Text-only mode168169- Keep runtime status `Not Run`.170- Produce planning/checklist output only.171- State that preview/render/GLB artifacts are `Not Produced` unless evidence exists.172173### Playbook B: Runtime-ready mode174175- Verify runtime stack and preflight evidence.176- Record exact actions, tools, inputs, output paths, and limitations.177- Do not upgrade status beyond the evidence.178179### Playbook C: Blocked mode180181- Identify blocker.182- Keep runtime/artifact status conservative.183- Recommend the next safe readiness or planning step.184185## Mode handling186187### Text-only mode188189Use when Blender is not available or not requested. Do not imply runtime execution.190191### Runtime-ready mode192193Use only when the user explicitly requests runtime work and readiness is documented.194195### Blocked runtime mode196197Use when requirements are missing. Report blockers and next safe action.198199## Validation checklist200201- [ ] Skill scope fits the user request.202- [ ] Required laws were applied.203- [ ] Runtime stack status is explicit.204- [ ] Artifact evidence status is explicit.205- [ ] No unsupported runtime route is presented as supported.206- [ ] No preview/render/GLB claim appears without evidence.207- [ ] Handoff names the next skill/doc.208209## Pass / Warn / Fail rubric210211| Verdict | Criteria |212|---|---|213| Pass | Output satisfies scope, evidence state is explicit, and no overclaim appears. |214| Warn | Output is useful but has missing inputs, partial evidence, or scoped uncertainty. |215| Fail | Output claims unsupported runtime/artifact success, ignores laws, or routes to an unsupported path. |216217## Failure handling218219- If evidence is missing, downgrade status instead of guessing.220- If runtime readiness is unknown, hand off to readiness skill.221- If a user asks for unsupported direct official MCP usage, mark it future research/unverified.222- If an unofficial bridge appears, keep it optional/local and outside release evidence.223224## Troubleshooting225226| Problem | Response |227|---|---|228| User wants “done” without evidence | Explain missing evidence and use `Not Run` / `Not Produced`. |229| User conflates skill install with runtime install | Separate skill install, runtime setup, and eval evidence. |230| User asks for marketplace/package claim | Keep as future until verified. |231232## Best practices233234- Prefer operational checklists over essays.235- Keep examples short and evidence-bound.236- Link docs instead of copying large reference content.237- Use precise status words.238- Hand off instead of expanding scope.239240## Good examples241242- “Runtime status: Not Run. Artifact status: Not Produced. Next safe action: run runtime readiness checklist for Path 1, host (a) Anthropic Blender Connector.”243- “Produced evidence exists at `<path>`, but validation is incomplete; status remains Produced, not Verified.”244245## Bad examples246247- “Everything is ready” without evidence.248- “GLB produced” without file path and validation notes.249- “Use official direct MCP from Claude Code” as a supported route.250251## User-facing response template252253```txt254Status: <Pass/Warn/Fail or scoped status>255Runtime: <state>256Artifacts: <state>257Evidence: <paths/links/logs or none>258Next safe action: <skill/doc/action>259Limitations: <gaps>260```261262## Anti-patterns263264- Turning a planning skill into a runtime executor.265- Treating third-party bridge setup as official.266- Treating read-only connector access as full runtime eval.267- Treating install success as artifact success.268269## Cross-skill handoff270271- Runtime readiness → `../official-runtime-readiness-checker/SKILL.md`272- Scene planning → `../product-hero-scene-planner/SKILL.md`273- Render/export evidence → `../render-export-evidence/SKILL.md`274- GLB handoff → `../glb-web-handoff/SKILL.md`275- Final response → `../non-blender-user-response-writer/SKILL.md`276277## Non-goals278279- Install Blender.280- Run Blender.281- Configure connector/MCP/CLI runtime.282- Create scene data.283- Render or export GLB.284- Claim marketplace/package availability.285286## References287288- `../../docs/skill-system.md`289- `../../docs/runtime-stack-strategy.md`290- `../../docs/evals/runtime-availability-checklist.md`291- `../../docs/evals/official-runtime-verification-criteria.md`292- `../../docs/distribution-strategy.md`