Initial release: 20 Blender 5.2 agent skills

- 20 skills covering modeling, UVs, PBR, baking, rigging, animation, optimization, export, rendering, simulation and QA.
- 26 tested scripts (MCP + headless).
- Installers for Claude Code, Codex, OpenCode, Gemini CLI, Copilot and Cursor; validator, test suite, CI.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NaajJ5JJbR8DFcNCPt4xXX

Author: EL4CTEO

.claude-plugin/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "blender-agent-skills",
+  "description": "Blender 5.2 workflow skills for AI agents",
+  "owner": { "name": "EL4CTEO" },
+  "plugins": [
+    {
+      "name": "blender-agent-skills",
+      "source": "./",
+      "description": "20 tested Blender skills: model, UV, texture, bake, rig, animate, optimize, export, render, QA"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "blender-agent-skills",
+  "version": "0.1.0",
+  "description": "Professional Blender 5.2 workflows for AI agents: modeling, retopo/UV, PBR, baking, rigging, animation, optimization, export (Roblox/Unity/Unreal/Godot/web), rendering, simulation, QA.",
+  "author": { "name": "EL4CTEO" },
+  "homepage": "https://github.com/EL4CTEO/blender-skills",
+  "repository": "https://github.com/EL4CTEO/blender-skills",
+  "license": "MIT",
+  "keywords": ["blender", "bpy", "3d", "game-assets", "rigging", "pbr", "roblox", "unity", "unreal", "godot"]
+}

.gitattributes

@@ -0,0 +1,4 @@
+* text=auto eol=lf
+*.ps1 text eol=crlf
+*.png binary
+*.blend binary

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python tools/sync_shared.py --check
+      - run: python tools/validate_skills.py
+      - run: python tools/trigger_check.py
+      - run: bash install/install.sh --project "$RUNNER_TEMP/p" --agent all --copy
+
+  blender-tests:
+    runs-on: ubuntu-latest
+    env:
+      BLENDER_VERSION: "5.2.2"
+      BAS_SKIP_GPU: "1"   # no GPU on hosted runners: render tests are skipped
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/cache@v4
+        id: cache
+        with:
+          path: ~/blender
+          key: blender-${{ env.BLENDER_VERSION }}
+      - name: Download Blender
+        if: steps.cache.outputs.cache-hit != 'true'
+        run: |
+          mkdir -p ~/blender
+          curl -sL "https://download.blender.org/release/Blender${BLENDER_VERSION%.*}/blender-${BLENDER_VERSION}-linux-x64.tar.xz" \
+            | tar -xJ -C ~/blender --strip-components=1
+      - name: System libs
+        run: sudo apt-get update && sudo apt-get install -y libxi6 libxkbcommon0 libxxf86vm1 libxfixes3 libxrender1 libgl1 libegl1 libsm6
+      - name: Run tests
+        run: BLENDER_EXE=~/blender/blender python3 tools/run_tests.py

.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.blend1
+*.blend2
+dist/
+render/
+export/
+textures/
+.DS_Store
+.claude/settings.local.json

AGENTS.md

@@ -0,0 +1,38 @@
+# 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-mcp `execute_blender_code`, or headless with `python skills/blender-core/scripts/run_in_blender.py <script.py> -- <args>`.
+- Run scripts; don't read them. Every `skills/*/scripts/*.py` documents its flags in its docstring and prints one compact JSON result.
+- Load a skill's `references/*.md` only 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-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, bake, root motion |
+| 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-simulation | rigid body, cloth (classic + 5.2 nodes), fluids |
+| 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.py` only, then run `python 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; set `BLENDER_EXE` if it isn't found). Set `BAS_SKIP_GPU=1` on 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.

CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## [Unreleased]
+- 20 Blender 5.2 skills for AI agents (Claude Code, Codex, OpenCode, Gemini CLI, Copilot, Cursor).
+- 26 tested scripts (MCP + headless): QA, baking, UV/texel density, retopo, LODs, export presets, Rigify, skinning, animation bake, GN builder, render, lookdev, simulation, batch.
+- Installers for every agent, Claude Code plugin/marketplace, validator, headless test suite, CI.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

README.md

@@ -0,0 +1,63 @@
+# Blender Agent Skills
+
+Professional Blender workflows packaged as **Agent Skills** for AI coding agents: Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot and Cursor.
+
+There are 20 skills covering the full 3D pipeline (modeling, UVs, PBR, baking, rigging, animation, optimization, export, rendering, simulation and QA), built for **Blender 5.2 LTS+**. Every script is tested in a real Blender.
+
+## Install
+
+**Claude Code** (plugin):
+```
+/plugin marketplace add EL4CTEO/blender-skills
+/plugin install blender-agent-skills@blender-agent-skills
+```
+
+**Any agent** (clone, then run the installer):
+```bash
+git clone https://github.com/EL4CTEO/blender-skills
+./blender-skills/install/install.sh          # macOS / Linux
+.\blender-skills\install\install.ps1         # Windows
+```
+The default installs into `~/.claude/skills` and `~/.agents/skills`. `.agents/skills` is read by Codex, OpenCode, Gemini CLI, Copilot and Cursor. Options: `--agent claude|codex|opencode|gemini|copilot|cursor|all`, `--project DIR` for a single project, `--uninstall`.
+
+**Requirements:** Blender 5.2+. Optional: a Blender MCP server lets agents work in your open Blender. Without one, agents run Blender in the background.
+
+## Skills
+
+| Skill | What it does |
+|---|---|
+| `blender-core` | Start here: runs code, routes tasks, 5.x API rules |
+| `blender-scene-setup` | Units, naming, collections, asset libraries |
+| `blender-hardsurface-modeling` | Bevels, booleans, weighted normals |
+| `blender-sculpting` | Organic sculpting workflow |
+| `blender-retopology-uv` | Retopology, UVs, texel density |
+| `blender-pbr-materials` | Correct PBR materials from textures |
+| `blender-texture-baking` | Normal, AO and curvature maps, ORM |
+| `blender-geometry-nodes` | Procedural modeling from simple JSON |
+| `blender-character-rigging` | Rigify, skinning, game skeletons |
+| `blender-facial-shapekeys` | ARKit 52 blendshapes, visemes |
+| `blender-animation` | Actions, NLA, mocap, root motion |
+| `blender-game-optimization` | Budgets, LODs, draw calls |
+| `blender-export-pipelines` | Roblox, Unity, Unreal, Godot, web, USD |
+| `blender-rendering` | Cycles and EEVEE, batch rendering |
+| `blender-lighting-lookdev` | Studio lighting, HDRI, turntables |
+| `blender-simulation` | Rigid bodies, cloth, fluids |
+| `blender-addon-development` | Blender extensions |
+| `blender-pipeline-automation` | Batch jobs and file conversion |
+| `blender-asset-qa` | Catches z-fighting, floating parts, bad normals and weights |
+| `blender-workflow-recipes` | Complete asset playbooks |
+
+## Try it
+
+> "Make a game-ready crate for Unreal with baked normals and LODs."
+> "Rig this character with Rigify and export it to Unity with a walk cycle."
+> "Check this model for z-fighting and floating parts, then export it for Roblox."
+
+## Development
+
+```bash
+python tools/validate_skills.py   # spec + token budget checks
+python tools/run_tests.py         # 43 headless Blender tests (BLENDER_EXE to override)
+```
+
+MIT License

install/install.ps1

@@ -0,0 +1,56 @@
+<#
+Install blender-agent-skills for your AI agent(s) on Windows.
+  .\install\install.ps1 [-Agent claude,agents,codex,opencode,gemini,copilot,cursor,all]
+                        [-Scope user|project] [-Project DIR] [-Link] [-Uninstall] [-Skills a,b]
+Defaults: -Agent claude,agents  -Scope user  (copies; -Link makes junctions, no admin needed)
+"agents" = ~/.agents/skills, read by Codex, OpenCode, Gemini CLI, GitHub Copilot and Cursor.
+#>
+param(
+    [string[]]$Agent = @("claude", "agents"),
+    [ValidateSet("user", "project")][string]$Scope = "user",
+    [string]$Project = (Get-Location).Path,
+    [switch]$Link,
+    [switch]$Uninstall,
+    [string[]]$Skills = @()
+)
+$ErrorActionPreference = "Stop"
+$Root = Split-Path -Parent $PSScriptRoot
+if ($PSBoundParameters.ContainsKey("Project")) { $Scope = "project" }
+if ($Agent -contains "all") { $Agent = @("claude", "agents", "opencode", "gemini", "copilot", "cursor") }
+
+function Get-Target([string]$a) {
+    $u = $HOME; $p = $Project
+    $map = @{
+        "claude:user" = "$u\.claude\skills";            "claude:project" = "$p\.claude\skills"
+        "agents:user" = "$u\.agents\skills";            "agents:project" = "$p\.agents\skills"
+        "codex:user" = "$u\.agents\skills";             "codex:project" = "$p\.agents\skills"
+        "opencode:user" = "$u\.config\opencode\skills"; "opencode:project" = "$p\.opencode\skills"
+        "gemini:user" = "$u\.gemini\skills";            "gemini:project" = "$p\.gemini\skills"
+        "copilot:user" = "$u\.copilot\skills";          "copilot:project" = "$p\.github\skills"
+        "cursor:user" = "$u\.cursor\skills";            "cursor:project" = "$p\.cursor\skills"
+    }
+    $k = "${a}:$Scope"
+    if (-not $map.ContainsKey($k)) { throw "unknown agent $a" }
+    return $map[$k]
+}
+
+foreach ($a in $Agent) {
+    $dst = Get-Target $a
+    New-Item -ItemType Directory -Force $dst | Out-Null
+    $n = 0
+    foreach ($s in Get-ChildItem -Directory (Join-Path $Root "skills")) {
+        if ($Skills.Count -and -not ($Skills -contains $s.Name)) { continue }
+        $target = Join-Path $dst $s.Name
+        if (Test-Path $target) {
+            $item = Get-Item $target -Force
+            if ($item.LinkType) { $item.Delete() } else { Remove-Item -Recurse -Force $target }
+        }
+        if (-not $Uninstall) {
+            if ($Link) { New-Item -ItemType Junction -Path $target -Target $s.FullName | Out-Null }
+            else { Copy-Item -Recurse $s.FullName $target -Exclude "__pycache__" }
+        }
+        $n++
+    }
+    $verb = if ($Uninstall) { "removed" } else { "installed" }
+    Write-Output "$verb $n skills -> $dst ($a)"
+}