Professional Blender 5.2 workflows as Agent Skills for Claude Code, Codex, Gemini CLI, Copilot and Cursor: modeling, UVs, PBR, baking, rigging, animation, export and QA.
Python 3dagent-skillsai-agentsblenderblender-pythonbpyclaude-codeclaude-skillscodexgame-assetsgemini-cligodotmcppbrriggingrobloxunityunreal-engine
Blender Agent Skills: agent instructions
This repo contains Agent Skills (skills/<name>/SKILL.md, agentskills.io format) for Blender 5.2 LTS+. Codex, OpenCode, Gemini CLI, Copilot and Cursor read them from .agents/skills; Claude Code reads them from .claude/skills (see install/).
Using the skills
- Start any Blender task with
skills/blender-core/SKILL.md. It routes to the specialized skill and defines how to run code: live through the blender-mcpexecute_blender_code, or headless withpython skills/blender-core/scripts/run_in_blender.py <script.py> -- <args>. - Run scripts; don't read them. Every
skills/*/scripts/*.pydocuments its flags in its docstring and prints one compact JSON result. - Load a skill's
references/*.mdonly when the SKILL.md points you there. - Always finish geometry work with
skills/blender-asset-qa(numbers + a visual check).
| Skill | Use for |
|---|---|
| blender-core | execution, 5.x API rules, routing (start here) |
| blender-scene-setup | units, naming, collections, linking, asset libraries |
| blender-hardsurface-modeling | bevels, booleans, weighted normals, props |
| blender-sculpting | organic forms, multires, procedural sculpt ops |
| blender-retopology-uv | retopo, UVs, texel density |
| blender-pbr-materials | Principled BSDF, texture sets, color spaces |
| blender-texturing | wear/grime/dust layers, decals, trims, painting |
| blender-texture-baking | normal/AO/curvature/ID bakes, ORM |
| blender-geometry-nodes | procedural modeling, JSON node-tree builder |
| blender-character-rigging | Rigify, skinning, game skeletons |
| blender-facial-shapekeys | ARKit 52, visemes, correctives |
| blender-animation | actions/slots, NLA, mocap retarget, loops, bake, root motion |
| blender-clothing | garments, weights, body masking, morphs, poke check |
| blender-hair-grooming | hair curves, node assets, hair cards |
| blender-game-optimization | budgets, LODs, draw calls |
| blender-export-pipelines | Roblox, Unity, Unreal, Godot, web, USD |
| blender-rendering | Cycles/EEVEE, color management, batch |
| blender-lighting-lookdev | lights, HDRI, cameras, turntables |
| blender-stylized-npr | toon shading, outlines, Line Art, Grease Pencil |
| blender-environment-kits | terrain, scatter, modular kit checks |
| blender-video-editing | VSE edits, motion tracking |
| blender-simulation | rigid body, cloth (classic + 5.2 nodes), fluids |
| blender-time-of-day | sky/sun/moon by time, night, fog, moods |
| blender-weather-fx | rain, snow, wetness, puddles, lightning |
| blender-addon-development | extensions, operators, UI |
| blender-pipeline-automation | headless batch, conversion, CI |
| blender-asset-qa | review gate: z-fighting, floating parts, normals, UVs, weights |
| blender-workflow-recipes | end-to-end playbooks |
Working on this repo
- Shared helper: edit
shared/_bpyx.pyonly, then runpython tools/sync_shared.py. - Validate:
python tools/validate_skills.py(spec, token budgets, links, script contract). - Test:
python tools/run_tests.py [filter](needs Blender 5.2; setBLENDER_EXEif it isn't found). SetBAS_SKIP_GPU=1on machines without a GPU. - Keep each SKILL.md ≤ ~2.5k tokens and each description ≤ 400 chars. Verify every API claim against a running Blender 5.2 before writing it.