Skip to content

MAX-786/claude-3d-harness / library/cc/text-to-blender

text-to-blender

Verified

Drive Blender from natural language. Converts plain-English requests ("model a sword and render it with cinematic lighting", "make this glass look frosted", "set up three-point lighting", "export this scene as glTF for the web") into Blender Python code executed via the Blender MCP server. Acts as the orchestrator that picks and chain-loads specialised sub-skills (blender-modeling, blender-materials, blender-lighting, blender-cameras, blender-rendering, blender-animation, blender-export, wireframe-to-3d, blender-pro-workflow, blender-skill-harmonizer, quality-refinement-autoloop). Use this skill whenever the user wants Claude to do anything in Blender, including creating geometry, applying materials, lighting a scene, framing a camera, rendering, animating, or exporting. Make sure to invoke this skill even if the user does not say "Blender" — also covers requests like "create a 3D model of...", "render this...", "make a glTF from...", "set up a scene with...", or any 3D-creation task. Requires the Blender MCP addon (ahujasid/blender-mcp) running on port 9876.

FileKindSize
SKILL.mdskill md18.0 KB
assets/v0.4.0-validation/README.mdmarkdown1.5 KB
assets/v0.4.0-validation/test1-modeling-materials-lighting-render.webpbinary7.2 KB
assets/v0.4.0-validation/test2-glass-cycles.webpbinary12.9 KB
assets/v0.4.0-validation/test3-anim-frame001.webpbinary3.0 KB
assets/v0.4.0-validation/test3-anim-frame048.webpbinary3.0 KB
assets/v0.4.0-validation/test3-anim-frame096.webpbinary3.0 KB
assets/v0.6.0-round2-validation/M_sword_FINAL_v0.6.0.webpbinary4.2 KB
assets/v0.6.0-round2-validation/M_sword_attempt1_broken_world.webpbinary4.8 KB
assets/v0.6.0-round2-validation/M_sword_attempt2_clean_world.webpbinary6.4 KB
assets/v0.6.0-round2-validation/M_sword_attempt3_aimed_lights.webpbinary8.1 KB
assets/v0.6.0-round2-validation/M_sword_attempt4_correct_dimensions_wrong_orientation.webpbinary3.2 KB
assets/v0.6.0-round2-validation/M_sword_attempt5_rotated_no_taper.webpbinary3.3 KB
assets/v0.6.0-round2-validation/M_sword_attempt6_with_pointed_tip.webpbinary3.7 KB
assets/v0.6.0-round2-validation/README.mdmarkdown2.8 KB
assets/v0.7.0-bottle-validation/README.mdmarkdown2.4 KB
assets/v0.7.0-bottle-validation/bottle_FINAL_v0.7.0.webpbinary8.7 KB
assets/v0.7.0-bottle-validation/bottle_first_try.webpbinary8.4 KB
assets/v0.8.0-chair-validation/README.mdmarkdown3.7 KB
assets/v0.8.0-chair-validation/chair_FINAL_v0.8.0.webpbinary16.6 KB
assets/v0.8.0-chair-validation/chair_attempt1_simple_rectangles.webpbinary18.5 KB
assets/v0.8.0-chair-validation/chair_attempt2_overcooked_wood.webpbinary26.0 KB
assets/v0.8.0-chair-validation/chair_attempt3_balanced_wood.webpbinary14.1 KB
assets/v0.9.0-validation/01_bottle_glass_class_lighting.webpbinary7.9 KB
assets/v0.9.0-validation/02_bottle_proper_wine_density.webpbinary8.5 KB
assets/v0.9.0-validation/03_aviator_wireframe_to_3d.webpbinary6.3 KB
assets/v0.9.0-validation/04_aviator_chained_upgrade.webpbinary13.4 KB
assets/v0.9.0-validation/05_aviator_proper_rayban_dimensions.webpbinary11.6 KB
assets/v1.1.0-validation/desk_lamp_emission.webpbinary7.9 KB
assets/v1.2.0-validation/01_broadcaster_too_bright.webpbinary9.2 KB
assets/v1.2.0-validation/02_broadcaster_neutral_dominates.webpbinary8.6 KB
assets/v1.2.0-validation/03_broadcaster_synthwave_FINAL.webpbinary10.9 KB
assets/v1.2.0-validation/04_broadcaster_with_features_still_not_human.webpbinary11.9 KB
references/assembly-order.mdmarkdown4.8 KB
references/blender-version-compat.mdmarkdown3.9 KB
references/common-object-dimensions.mdmarkdown12.0 KB

references/blender-version-compat.md

View on GitHub
# Blender Version Compatibility Matrix

This plugin is developed against **Blender 5.1.1** (validated end-to-end on macOS). Most patches include forward/backward compatibility for **Blender 4.x** users.

## Compat-critical patches in this plugin

| Patch | Blender 4.x behaviour | Blender 5.x behaviour | Strategy |
|-------|----------------------|----------------------|----------|
| EEVEE engine name (`blender-rendering` Recipe 3) | `BLENDER_EEVEE` (4.0–4.1) or `BLENDER_EEVEE_NEXT` (4.2+) | `BLENDER_EEVEE` (5.x renamed back) | `try`/`except` with fallback — works on every version |
| Action F-curve access (`blender-animation` Recipe 3) | `action.fcurves` (legacy actions) | `action.layers[].strips[].channelbags[].fcurves` (layered actions only) | `get_fcurves_compat()` helper: tries `.fcurves` first, falls back to walking layers |
| `Mesh.use_auto_smooth` attribute | exists | **REMOVED** | Code wraps in `hasattr(mesh, 'use_auto_smooth')` or simply uses `bpy.ops.object.shade_smooth()` instead |
| `Subsurface IOR` and `Weight` BSDF inputs (`blender-materials` Recipe 9) | Reachable by string-key lookup | `enabled=False` flag blocks string-key lookup | `set_input(node, name, value)` helper iterates inputs to find by name |
| Coloured-glass volume density (`blender-materials` Recipe 6b) | Same physics — recipe values are version-agnostic | Same | No special handling needed |

## What's NOT cross-tested

- **Blender 3.x and earlier**: Not supported. Many recipes use Principled BSDF v2 inputs (Coat Weight, Sheen Weight, Subsurface Weight) that don't exist on the older Principled BSDF.
- **Blender 4.0 specifically**: Not directly tested in this validation pass. The compat helpers should work but the `BLENDER_EEVEE_NEXT` engine name introduced in 4.2 means a 4.0 user hits the fallback path — verified to be `BLENDER_EEVEE`.

## Validation status (as of v0.9.0)

| Blender version | Status | Notes |
|----------------|--------|-------|
| 5.1.1 | ✅ Fully validated | All scenes (sword, bottle, chair, aviator wireframe) tested end-to-end |
| 4.2 / 4.3 / 4.4 LTS | ⚠️ Compat code present, **not directly tested** | The try/except + helper patterns should work; would need a 4.x install to confirm |
| 4.0 / 4.1 | ⚠️ Compat code present, **not directly tested** | Same as 4.2 — should work via fallback paths |
| 3.x and earlier | ❌ Not supported | Principled BSDF v1 missing required inputs |

## How to confirm cross-version compat in your install

After installing this plugin, run a quick smoke test:

```python
# In Blender's Scripting workspace — paste and run:
import bpy

# 1. Test engine fallback
scene = bpy.context.scene
try:
    scene.render.engine = 'BLENDER_EEVEE_NEXT'
    print(f"engine: NEXT path used, resolved to {scene.render.engine}")
except (TypeError, ValueError):
    scene.render.engine = 'BLENDER_EEVEE'
    print(f"engine: fallback path used, resolved to {scene.render.engine}")

# 2. Test BSDF input access
mat = bpy.data.materials.new('test')
mat.use_nodes = True
b = mat.node_tree.nodes['Principled BSDF']
disabled_inputs = [inp.name for inp in b.inputs if not inp.enabled]
print(f"disabled BSDF inputs (need set_input helper): {disabled_inputs}")
bpy.data.materials.remove(mat, do_unlink=True)

# 3. Test Action API
print(f"version: {bpy.app.version_string}")
print(f"Action.layers attribute: {hasattr(bpy.types.Action, 'layers')}")
```

Expected output on Blender 5.1.1:
```
engine: fallback path used, resolved to BLENDER_EEVEE
disabled BSDF inputs (need set_input helper): ['Weight', 'Subsurface IOR']
version: 5.1.1
Action.layers attribute: True
```

If you see a different version with `disabled BSDF inputs: []` and the `BLENDER_EEVEE_NEXT` succeeds (resolving to that exact name), you're on Blender 4.2-4.4.

If you find recipes that fail on your version, please file an issue at https://github.com/RobLe3/cc-blender-skill/issues with:
- `bpy.app.version_string`
- The specific recipe / SKILL.md section
- The error message
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall