AB
AiBoss
project

blender-skills - 把 Blender 3D 工作流打包成 AI 编码代理可用的 Agent Skills

blender-skills 是维护者 EL4CTEO 发布的开源项目,把 28 项 Blender 3D 制作流程封装为 Agent Skills,供 Claude Code、Codex、Gemini CLI、Copilot、Cursor 等 AI 编码代理调用。项目采用 MIT 许可证,面向 Blender 5.2 LTS 及以上版本,覆盖建模、UV、贴图、绑定、动画、渲染、导出与资产质检等环节。

blender-skills 是一个把 Blender 3D 制作流程封装成 Agent Skills 的开源项目。按项目自述,它面向 Claude Code、Codex、OpenCode、Gemini CLI、GitHub Copilot 和 Cursor 这类 AI 编码代理,让代理在接到「做一个可用于 Unreal 的游戏道具箱」「给角色绑定并导出到 Unity」这类任务时,能按预先写好的技能说明调用 Blender 完成操作。它适合已经在用 AI 编码代理、又希望把 3D 资产生产环节交给代理执行的个人与技术美术团队,也适合想把重复性 Blender 操作脚本化的工作室。

维护者与状态

项目由 EL4CTEO 维护,仓库创建于 2026-10-14,最后一次提交在 2026-10-30,最新正式版本为 v1.2.0,发布于 2026-10-30。截至 2026-11-01,仓库获得 642 个星标。从创建到发布 v1.2.0 只隔了约两周,属于起步阶段但已有版本化发布的项目。

主要能力

据项目说明,仓库共包含 28 项技能,覆盖从建模到交付的完整 3D 管线,且每个脚本都在真实的 Blender 中测试过。以下分类均来自项目自述:

  • 基础与场景:blender-core 作为入口,负责运行代码、路由任务并约束 5.x API 规则;blender-scene-setup 处理单位、命名、集合与资产库。
  • 建模与雕刻:blender-hardsurface-modeling 覆盖倒角、布尔与加权法线;blender-sculpting 面向有机形体雕刻;blender-retopology-uv 处理重拓扑、UV 与纹素密度;blender-geometry-nodes 支持用简单 JSON 驱动程序化建模。
  • 材质与贴图:blender-pbr-materials 从贴图构建正确的 PBR 材质;blender-texturing 处理边缘磨损、污渍、灰尘、贴花与 trim sheet;blender-texture-baking 烘焙法线、AO、曲率图与 ORM。
  • 角色与动画:blender-character-rigging 涉及 Rigify、蒙皮与游戏骨架;blender-facial-shapekeys 面向 ARKit 52 个 blendshape 与口型;blender-animation 处理动作、动捕重定向、循环检查与根运动;blender-clothing 与 blender-hair-grooming 分别处理不穿模的服装和毛发、毛皮与游戏发片。
  • 场景与特效:blender-environment-kits 生成地形、森林与模块化关卡套件;blender-time-of-day 与 blender-weather-fx 负责黄金时刻、夜景、雾、雨雪、湿街、水洼与闪电;blender-simulation 覆盖刚体、布料与流体。
  • 渲染与后期:blender-rendering 使用 Cycles 与 EEVEE 并支持批量渲染;blender-lighting-lookdev 处理影棚布光、HDRI 与转台;blender-stylized-npr 提供卡通与动漫着色及描边;blender-video-editing 可剪辑视频与跟踪摄像机。
  • 交付与工程化:blender-game-optimization 管理预算、LOD 与 draw call;blender-export-pipelines 面向 Roblox、Unity、Unreal、Godot、Web 与 USD;blender-addon-development 用于编写 Blender 扩展;blender-pipeline-automation 处理批处理与文件转换;blender-asset-qa 检查 z-fighting、悬空部件、错误法线、权重与贴图;blender-workflow-recipes 提供完整资产操作手册。

使用入口

仓库地址:EL4CTEO/blender-skills。

据 README,Claude Code 用户可通过插件市场安装:

/plugin marketplace add EL4CTEO/blender-skills
/plugin install blender-agent-skills@blender-agent-skills

其他代理可先克隆仓库再运行安装脚本:

git clone https://github.com/EL4CTEO/blender-skills
./blender-skills/install/install.sh
.\blender-skills\install\install.ps1

项目说明默认安装到 ~/.claude/skills 与 ~/.agents/skills,后者可被 Codex、OpenCode、Gemini CLI、Copilot 与 Cursor 读取。安装脚本支持 --agent 指定单个代理或 all、--project DIR 限定到单个项目,以及 --uninstall 卸载。开发侧还提供 tools/validate_skills.py 做规范与 token 预算检查,tools/run_tests.py 运行 67 项无头 Blender 测试。

许可与限制

项目采用 MIT 许可证。据项目说明,运行需要 Blender 5.2 及以上版本;Blender MCP server 是可选组件,接入后代理可在用户已打开的 Blender 中工作,没有它时代理会在后台运行 Blender。项目自述所有脚本均在真实 Blender 中测试,但仓库未在素材中给出性能或质量基准,实际产出仍需使用者自行验证。