EL4CTEO/blender-skills

Blender Agent Skills

What it is

• A collection of 22 ready‑to‑use Agent Skills that let AI coding assistants (Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot, Cursor) drive Blender 5.2 LTS+ for professional 3D asset creation.
• Each skill is a small script that encapsulates a specific part of the 3D pipeline—modeling, UVs, PBR material setup, baking, rigging, animation, optimization, export, rendering, environment effects, QA, etc.
• The skills are tested in a real Blender installation and can be called from an AI agent as if they were built‑in commands.

Installation

• Claude Code: add the repo via the Claude plugin marketplace and install the blender-agent-skills package.
• Other agents: clone the repo and run the provided installer (install.sh for macOS/Linux, install.ps1 for Windows). By default the skills are placed in ~/.claude/skills and ~/.agents/skills, which the supported agents read automatically.
• Optional: run a Blender MCP server so agents can control an already‑open Blender UI; otherwise the scripts launch Blender in headless mode.

Skill catalogue (short description from the README)

Skill	Function
blender-core	Entry point: runs code, routes tasks, enforces API rules for Blender 5.x
blender-scene-setup	Sets units, naming conventions, collections, asset libraries
blender-hardsurface-modeling	Bevels, booleans, weighted normals for hard‑surface work
blender-sculpting	Organic sculpting workflow
blender-retopology-uv	Retopology, UV unwrap, texel‑density checks
blender-pbr-materials	Generates correct PBR materials from texture maps
blender-texture-baking	Bakes normal, AO, curvature, ORM maps
blender-geometry-nodes	Procedural modeling via simple JSON input
blender-character-rigging	Rigify setup, skinning, game‑engine skeletons
blender-facial-shapekeys	Adds ARKit‑style 52 blendshapes and visemes
blender-animation	Creates actions, NLA tracks, imports mocap, root motion
blender-game-optimization	Checks budgets, creates LODs, reduces draw calls
blender-export-pipelines	Export to Roblox, Unity, Unreal, Godot, web, USD
blender-rendering	Cycles & EEVEE batch rendering
blender-lighting-lookdev	Studio lighting, HDRI, turntable renders
blender-simulation	Rigid bodies, cloth, fluid simulations
blender-time-of-day	Golden‑hour, night, fog, mood lighting
blender-weather-fx	Rain, snow, wet streets, puddles, lightning
blender-addon-development	Boilerplate for creating custom Blender add‑ons
blender-pipeline-automation	Batch jobs, file conversion scripts
blender-asset-qa	Detects z‑fighting, floating parts, bad normals/weights
blender-workflow-recipes	End‑to‑end playbooks for common asset types

How it helps

• Prompts like “Make a game‑ready crate for Unreal with baked normals and LODs.” are turned into concrete Blender operations without the user writing any Python.
• The comparison page (linked in the README) shows noticeably higher quality results when the skills are used.

Development & testing

• tools/validate_skills.py checks skill specifications and token‑budget limits.
• tools/run_tests.py runs 50 headless Blender tests (customizable via BLENDER_EXE).

License

• MIT License.

---

All details are taken directly from the repository’s README.