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

assets/v0.8.0-chair-validation/README.md

View on GitHub
# v0.8.0 Validation Renders — Chair (Multi-Part Assembly + Wood Material)

This round tested whether the patches generalise to a third scene class: **multi-part assembly with non-vertical bbox + procedural wood**. They do — with one important caveat about design quality vs build correctness.

## The iteration arc

| File | What it shows | Lesson |
|------|---------------|--------|
| `chair_attempt1_simple_rectangles.webp` | 6 plain rectangles + subtle wood texture | User reaction: "very simple chair with a printed plastic wrap" — texture too subtle, shape too plain |
| `chair_attempt2_overcooked_wood.webp` | After ramping up bump strength + ColorRamp contrast + Voronoi knots | User reaction (anticipated): "looks like rough timber" — over-corrected from subtle to busy |
| `chair_attempt3_balanced_wood.webp` | Tuned bump down + smoother ColorRamp + fewer knots | Wood now reads as wood (per user: "looks more like wood"), but model still simple rectangles |
| **`chair_FINAL_v0.8.0.webp`** | Added structural details: stretchers, slatted back, top rail | Recognizable Mission/Shaker chair; user reaction: "looks better, but is still an ugly designed chair" |

## What this round contributed

1. **Updated `references/common-object-dimensions.md`** for the dining chair entry: now includes structural details (stretchers, slatted back, top rail) and shape refinements (leg taper, edge bevels) — not just bare dimensions. Future "build a chair" requests should default to this baseline rather than 6 plain rectangles.

2. **Wood material tuning lessons** documented inline:
   - Bump strength 0.20 (not 0.6 — overcooks; not 0.15 — undercooks)
   - ColorRamp contrast: 3 stops with smooth gradient (0.20→0.38→0.55 in normalized brightness)
   - Voronoi influence ≤ 0.10 in OVERLAY mix (any more = busy "knotty" look)
   - Wave Scale 12, Distortion 3 — clear bands without distortion soup
   - Per-part grain orientation is a known limitation (Wave bands_direction='X' produces vertical stripes on vertical panels — looks like paneling). Future "wood-material per-part-orientation" recipe round.

## Important honest limitation

**The orchestrator can produce *functionally correct* objects but not *well-designed* ones.** The user's "ugly designed chair" feedback is accurate — we crossed from "rectangle stack" to "functional Mission chair", but a genuinely beautiful chair needs:

- Curved back slats (S-curve following spine)
- Profile-cut or turned legs
- Contoured seat with rolled front edge
- Tapered top rail
- Considered proportions beyond just real-world dimensions

These are *aesthetic choices*, not build errors. They require either a curated library of chair-design recipes (Wishbone, Eames, Windsor, etc.), or a design-quality refinement pass driven by reference images, or accepting that automated generation produces functional objects and aesthetic refinement is a separate human-driven step.

This is a real boundary of what the skill can do automatically. We ship v0.8.0 with the limitation documented rather than pretending the chair is hero-quality.

## What WORKED well in this round (positive signal)

- Pipeline produced a recognizable chair on first try (just like the bottle)
- v0.6.0+v0.7.0 patches all applied cleanly: world reset, real-world dimensions, subject-aware lighting, bbox-aware camera, mandatory visual checkpoint
- The connection-overlap pattern from v0.6.0 worked across leg-seat, seat-back, leg-stretcher junctions
- Procedural wood material generalised (used same pattern as the v0.6.0 sword leather grip)
- Multi-iteration refinement was driven by user feedback at each step — exactly the loop the orchestrator's mandatory visual validation is designed to facilitate
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: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated 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: 323kUpdated Claude CodeCodexVerifiedInstall