blender-skills README

项目的 README,来自 github.com/EL4CTEO/blender-skills。合并为一个 markdown 文件:README.md。

Blender Agent Skills

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 28 skills covering the full 3D pipeline (modeling, UVs, texturing, baking, rigging, animation, clothing, hair, environments, stylized looks, optimization, export, rendering, video, weather, simulation and QA), built for Blender 5.2 LTS+ (verified on 5.3). 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):

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 LTS or newer. Update to Blender 5.3.0 for the best experience: every skill is verified on it, and it adds KTX2 web export, the compositor effects stack and Gaussian splats. 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-texturing Edge wear, grime, dust, decals, trim sheets
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, mocap retargeting, loop checks, root motion
blender-clothing Clothes that follow the body without clipping
blender-hair-grooming Hair, fur and game hair cards
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-stylized-npr Toon/anime shading and outlines
blender-environment-kits Terrain, forests, modular level kits
blender-video-editing Edit videos, track cameras
blender-simulation Rigid bodies, cloth, fluids
blender-time-of-day Golden hour, night, fog and mood lighting
blender-weather-fx Rain, snow, wet streets, puddles, lightning
blender-addon-development Blender extensions
blender-pipeline-automation Batch jobs and file conversion
blender-asset-qa Catches z-fighting, floating parts, bad normals, weights and textures
blender-workflow-recipes Complete asset playbooks

With vs without skills

Same model, same prompts, outputs with the skills vs without them: see the comparison.

Concrete wall: without skills (left) vs with skills (right)

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." "Make this street a rainy night with puddles and lightning." "Give my character a shirt and hair cards, then retarget this Mixamo run onto it."

Development

python tools/validate_skills.py   # spec + token budget checks
python tools/run_tests.py         # 67 headless Blender tests (BLENDER_EXE to override)

MIT License

blender-skills (EL4CTEO/blender-skills)

正在搜索数据库…

这是什么?这是一套包含 28 个 Blender 技能的集合,供 Claude Code、Codex、Gemini CLI、Copilot、Cursor 等 AI 编程智能体使用,覆盖从建模到质量检查的完整 3D 制作流程。
它是 Blender 插件吗?严格来说两者都不是。它是一组 Agent Skills 文件夹,供你的编程智能体加载,由智能体为你编写并运行 Blender Python(bpy)脚本。这些脚本已在真实的 Blender 中测试过。
我安装前需要准备什么?Blender 5.2 LTS 或更新版本(推荐 5.3),以及受支持的智能体,例如 Claude Code、Codex、Gemini CLI、Copilot、Cursor 或 OpenCode。Blender MCP 服务器为可选项。
它能用于较旧的 Blender 版本吗?官方不支持。这些技能面向 Blender 5.2 LTS 及更新版本,并已在 5.3 上验证,因此不涵盖更早的版本。
我可以免费使用它吗?可以,本项目基于 MIT 许可证发布。
这 28 个技能覆盖了 3D 制作流程的哪些环节?建模、UV、贴图、烘焙、绑定、动画、服装、毛发、环境、优化、导出、渲染、模拟、天气效果和质量检查。建议从 blender-core 开始,它会把任务分派给其他技能。
它可以导出到哪些游戏引擎和格式?blender-export-pipelines 技能涵盖 Roblox、Unity、Unreal、Godot、网页(包括 Blender 5.3 中的 KTX2)以及 USD。
有证据表明这些技能能提升输出效果吗?README 中附有一份并排对比,展示同一模型在使用与不使用这些技能时的输出效果。
它能和 Blender 的 MCP 服务器配合使用吗?可以,这是可选的。Blender MCP 服务器让智能体直接在你已打开的 Blender 中工作,而不是在后台运行。
作者
EL4CTEO
大小
5.9 MB
星标
2K
时长
1个月
提交 · 90 天