EL4CTEO/blender-skills

Blender Agent Skills

它是什么

• 一套包含 22 个即用型 Agent Skills 的集合，允许 AI 编码助手（Claude Code、Codex、OpenCode、Gemini CLI、GitHub Copilot、Cursor）驱动 Blender 5.2 LTS+ 进行专业的 3D 资产创建。
• 每个技能都是一个小脚本，封装了 3D 流水线的特定部分——建模、UV、PBR 材质设置、烘焙、绑定、动画、优化、导出、渲染、环境特效、质量保证 (QA) 等。
• 这些技能在真实的 Blender 安装环境中经过测试，可以像内置命令一样被 AI 代理调用。

安装

• Claude Code: 通过 Claude 插件市场添加仓库并安装 blender-agent-skills 包。
• 其他代理: 克隆仓库并运行提供的安装程序（macOS/Linux 使用 install.sh，Windows 使用 install.ps1）。默认情况下，技能会被放置在 ~/.claude/skills 和 ~/.agents/skills 中，支持的代理会自动读取这些路径。
• 可选：运行 Blender MCP server，以便代理可以控制已打开的 Blender UI；否则脚本将以无头模式 (headless mode) 启动 Blender。

技能目录 (README 中的简短描述)

技能	功能
blender-core	入口点：运行代码、路由任务、强制执行 Blender 5.x 的 API 规则
blender-scene-setup	设置单位、命名规范、集合、资产库
blender-hardsurface-modeling	用于硬表面工作的倒角、布尔运算、加权法线
blender-sculpting	有机雕刻工作流
blender-retopology-uv	重拓扑、UV 展开、纹理密度检查
blender-pbr-materials	从纹理贴图生成正确的 PBR 材质
blender-texture-baking	烘焙法线、AO、曲率、ORM 贴图
blender-geometry-nodes	通过简单的 JSON 输入进行程序化建模
blender-character-rigging	Rigify 设置、蒙皮、游戏引擎骨架
blender-facial-shapekeys	添加 ARKit 风格的 52 个混合变形和音素
blender-animation	创建动作、NLA 轨道、导入动作捕捉、根运动
blender-game-optimization	检查预算、创建 LOD、减少绘制调用
blender-export-pipelines	导出至 Roblox、Unity、Unreal、Godot、Web、USD
blender-rendering	Cycles 和 EEVEE 批量渲染
blender-lighting-lookdev	工作室灯光、HDRI、转盘渲染
blender-simulation	刚体、布料、流体模拟
blender-time-of-day	黄金时刻、夜晚、雾气、氛围灯光
blender-weather-fx	雨、雪、湿路面、水坑、闪电
blender-addon-development	创建自定义 Blender 插件的样板代码
blender-pipeline-automation	批处理作业、文件转换脚本
blender-asset-qa	检测 Z 轴冲突、悬浮部件、错误的法线/权重
blender-workflow-recipes	常见资产类型的端到端操作手册

如何提供帮助

• 像 “为 Unreal 制作一个游戏就绪的板条箱，带有烘焙法线和 LOD” 这样的提示词，会被转化为具体的 Blender 操作，而无需用户编写任何 Python 代码。
• 对比页面（README 中有链接）显示，使用这些技能后，结果质量有显著提高。

开发与测试

• tools/validate_skills.py 检查技能规范和 Token 预算限制。
• tools/run_tests.py 运行 50 个无头 Blender 测试（可通过 BLENDER_EXE 自定义）。

许可证

• MIT License。

---

所有详细信息均直接取自仓库的 README。