CheshireJCat/create-3d-model-skill / skills/create-3d-model
create-3d-model
VerifiedCreate and refine portable 3D models from text prompts, one or more reference images, wireframes, orthographic views, templates, texture atlases, or existing 3D assets. Use whenever Codex must model or reconstruct geometry, match visual references, create materials and UVs, rig or animate a model, validate shape or multiview fidelity, repair a subpar asset, edit an existing Blender scene, or export GLB, glTF, FBX, OBJ, USD, STL, or another requested 3D format. Uses Blender and BlenderMCP as the production backend while treating the transferable 3D model as the normal deliverable.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 10.9 KB |
| UPSTREAM_LICENSE | other | 1.0 KB |
| agents/openai.yaml | config | 242 B |
| references/blender-5-compat.md | markdown | 3.3 KB |
| references/capability-map.md | markdown | 6.4 KB |
| references/codex-integration.md | markdown | 7.2 KB |
| references/core/assembly-order.md | markdown | 4.8 KB |
| references/core/blender-version-compat.md | markdown | 3.9 KB |
| references/core/common-object-dimensions.md | markdown | 11.9 KB |
| references/modeling-patterns.md | markdown | 7.2 KB |
| references/upstream.md | markdown | 2.8 KB |
| references/visual-validation.md | markdown | 3.6 KB |
references/core/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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |