blender-modeler — Claude Code skill: Blender mesh modeling and cleanup
blender-modeler — a skill for Claude Code and other platforms handling 3D modeling in Blender via MCP. It manages geometry, modifier stacks, and scene organization.
MIT 745 installs ★ 4,589 updated 2026-11-06
npx skills add arjun988/blender-skills --skill blender-modeler -a claude-codeWhat blender-modeler does
This skill automates Blender modeling workflows including primitive creation, mesh editing, modifier stack management, and mesh cleanup. It defaults to a non-destructive approach, allowing for safe iterations throughout the modeling process.
The system controls scene hierarchy via MCP, automating collection creation and naming conventions. Users must maintain topology integrity, apply transforms before export, and use snapping for precision. The skill restricts premature modifier application and mandates using the SM_ prefix for object naming.
What it helps with
- organize scene hierarchy and collections
- manage modifier stacks
- perform mesh cleanup
- create primitives with precise dimensions
Example prompts for the agent
- Subdivide the object using
blender-modeler - Configure the modifier stack for
SM_Chairwithblender-modeler - Clean up unnecessary geometry using
blender-modeler
How to install blender-modeler
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill blender-modeler -a claude-code2Manually: put the files in place
~/.claude/skills/blender-modeler/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/blender-modeler/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill blender-modeler -a codex2Manually: put the files in place
.agents/skills/blender-modeler/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill blender-modeler -a cursor2Manually: put the files in place
.cursor/skills/blender-modeler/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arjun988/blender-skills .claude/skills/blender-modeler2Manually: put the files in place
.github/skills/blender-modeler/SKILL.md1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill blender-modeler -a gemini-cli2Platform CLI
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/blender-modelerManually: put the files in place
.devin/skills/blender-modeler/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill blender-modeler -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about blender-modeler
How to install blender-modeler in Claude Code?
Run npx skills add arjun988/blender-skills --skill blender-modeler -a claude-code.
What does blender-modeler do?
It automates core Blender tasks like mesh editing, modifier configuration, and collection management using MCP to execute operations.
What is required to use blender-modeler?
You need Blender installed and an MCP setup to allow the agent to interact with your scene.
Source text
SKILL.md · MIT
--- name: blender-modeler description: Core Blender modeling specialist for Edit Mode, modifiers, collections, precision modeling, and scene organization. Use for general 3D modeling, blockouts, cleanup, non-destructive workflows, and scene structure in Blender via MCP. license: MIT metadata: author: https://github.com/arjun988 version: "1.0.0" domain: blender role: specialist triggers: model, blockout, edit mode, modifier, collection, mesh, primitive, snap, pivot, scene organization related-skills: hard-surface, environment-artist, asset-optimization, uv-workflow --- # Blender Modeler Foundation modeling skill for all Blender geometry work. Non-destructive by default. MCP-first execution. ## When to Use - Blockouts and primary/secondary shape passes - General mesh editing not covered by discipline specialists - Scene organization, collections, instances - Modifier stack management - Cleanup: merge, normals, loose geometry - Precision modeling with snapping and numeric input ## Core Workflow ``` 1. Scene Setup → Collections, scale reference, naming 2. Blockout → Primitives, mirror, array 3. Shape Refinement → Edit mode or modifier-based edits 4. Modifier Stack → Non-destructive detail 5. Cleanup → Merge, normals, manifold check 6. Handoff → UV/materials or discipline specialist ``` ## Scene Organization Establish via MCP immediately: ``` COL_Project ├── COL_Reference # Scale refs, ortho images ├── COL_Blockout # Temporary blockout meshes ├── COL_Geo # Final geometry ├── COL_Collision # Proxy meshes └── COL_Instances # Empties/collections for instancing ``` Naming: `../references/naming-conventions.md` ## Modifier Stack Philosophy Preferred order (bottom to top): ``` 1. Mirror # Symmetry 2. Array # Repetition 3. Solidify # Thickness 4. Boolean # Cuts (prefer live booleans until export) 5. Bevel # Edge detail 6. Weighted Normal # Hard surface shading 7. Subdivision # Only when topology supports it ``` **Rules:** - Keep booleans live until export prep - Apply mirror only when topology is finalized - Never stack multiple subsurf without supporting loops - Document modifier purpose in object custom properties if complex ## Edit Mode Essentials | Operation | Use When | |-----------|----------| | Extrude (E) | Adding depth from faces | | Inset (I) | Panel lines, frames | | Loop Cut (Ctrl+R) | Adding resolution | | Knife (K) | Custom cuts | | Merge by Distance | Cleanup duplicates | | Recalculate Normals | Fix shading issues | Via MCP: execute equivalent operations; don't narrate UI. ## Precision Modeling - Enable snapping to grid/vertex/edge as appropriate - Use numeric input for exact dimensions - Set cursor to world origin for modular alignment - Apply scale before boolean operations - Use orthographic views for architectural accuracy ## Instancing Strategy | Method | Use Case | |--------|----------| | Linked Duplicate (Alt+D) | Identical props with variation potential | | Collection Instance | Modular kit pieces | | Geometry Nodes | Procedural scatter (see geometry-nodes) | | Array Modifier | Linear repetition | Prefer instances over duplicate geometry for repeated elements. ## Custom Normals - Enable Auto Smooth with appropriate angle (30°–60° hard surface) - Weighted Normal modifier for hard surface without extra geo - Mark sharp edges explicitly for bevel control - Clear custom split normals before retopology handoff ## Cleanup Checklist - [ ] Merge by distance (threshold: 0.0001m default) - [ ] Remove loose geometry - [ ] Delete interior faces - [ ] Recalculate outside normals - [ ] Apply scale if modifiers depend on it - [ ] Verify manifold (no holes unless intentional) - [ ] Check triangle count vs budget ## MCP Integration ``` 1. Create mesh objects via MCP 2. Apply modifiers via MCP 3. Query polycount after each major edit 4. Organize into collections via MCP 5. Duplicate to backup collection before destructive ops ``` See `../references/mcp-integration.md` ## Constraints ### MUST DO - Non-destructive workflow until export phase - Name objects `SM_` prefix immediately - Keep blockout separate from final geo - Apply transforms before boolean/export - Validate topology before handoff ### MUST NOT DO - Delete blockout before silhouette approved - Apply all modifiers prematurely - Leave default names (Cube.001) - Model without scale reference - Skip cleanup pass ## Reference Guide | Topic | Reference | Load When | |-------|-----------|-----------| | Modifier deep dive | `references/modifier-stack.md` | Complex modifier chains | | Scene organization | `references/scene-organization.md` | Large scenes | | Pipeline | `../references/asset-pipeline.md` | Phase context | ## Handoff Points | To Skill | When | |----------|------| | hard-surface | Mechanical/sci-fi detail pass | | environment-artist | Modular environment pieces | | character-artist | Organic human forms | | uv-workflow | Topology locked, ready for UVs | | asset-optimization | Pre-export performance pass |
© https://github.com/arjun988 · MIT · arjun988/blender-skills