by icesixgod
An agent skill for Blender character creation and repair, with nine-view references, face and hair workflows, and visual validation.
# Add to your Claude Code skills
git clone https://github.com/icesixgod/awesome-astra-blender-charactersGuides for using ai agents skills like awesome-astra-blender-characters.
awesome-astra-blender-characters is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by icesixgod. An agent skill for Blender character creation and repair, with nine-view references, face and hair workflows, and visual validation. It has 51 GitHub stars.
awesome-astra-blender-characters's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/icesixgod/awesome-astra-blender-characters" and add it to your Claude Code skills directory (see the Installation section above).
awesome-astra-blender-characters is primarily written in Python. It is open-source under icesixgod on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh awesome-astra-blender-characters against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
从人物参考图到可编辑 Blender 角色的 AI Agent 工作流。
中文 · English
本仓库提供可安装的 blender-character-workflow 技能，组织九视图参考、脸部与头发制作、局部修模、多视图验收和工程交付，重点是二次元人物与静态插画风格。技能不固定模型版本。
发布内容是技能指令和制作参考文档。仓库暂未提供人物模型、示例渲染、训练权重或一键三维重建程序；安装与检查脚本只服务于技能分发。
| 阶段 | 内容 |
|---|---|
| 输入检查 | 查看原图和已有工程，确认范围、用途与必须保留的特征，标明范围假定 |
| 九视图参考 | 新角色默认生成水平八方向与正上方共九张独立参考，检查方向、尺度与特征 |
| 配准与脸部 | 统一相机与关键点，先用正、侧、斜侧灰模检查脸型、下巴收口与深度，再完善五官 |
| 头发与材质 | 主发束与原生细丝、发根覆盖、冠部长发衔接、局部 UV、透明边缘与高光 |
| 局部修复 | 保留用户修改，分层定位肤色灰白、虹膜取样、镜片影响、缺口、穿插与 UV 拉伸 |
| 验收交付 | 固定相机对照，分别报告外形、工程和用途检查，注明 UV 与穿插检查范围，打包并重开最终 .blend |
局部修模直接进入相关阶段；仅整理文档不生成图片或修改工程。范围假定须说明，用户未答复不能视为同意删减原图可见部件。每轮修改先比较问题视角及相邻视角的实际渲染，未改善时重新定位原因；稳定后再从明确保存的同一版本输出交付多视图。
静态插画质感与遮挡诊断 包含图片纹理 UV 验收、保留腮红的肤色调整、眼面／虹膜／镜片分层检查，以及支撑面、内层与细丝的隔离诊断。执行可靠性 补充原生曲线与着色模式输入检查、局部修改的状态保留和实时视口异常恢复。
全身、服装、绑定、动画和打印有按需扩展指导，当前公开包尚未提供这些用途的端到端验证案例。
| 组件 | 何时需要 |
|---|---|
| 支持技能、图片查看及本地工具调用的 Agent 环境 | 执行工作流；提供 Codex 界面元数据 |
| 本地 Blender 与内置 Python／CLI | 建模、渲染和工程检查；先检测实际版本，仓库没有已验证的跨版本兼容矩阵 |
图像生成工具及 imagegen 技能 |
生成九视图或补纹理时；由宿主提供，本仓库不包含 |
| UI 自动化或 Blender MCP | 可选；CLI 可用时不要求 MCP |
| 外部 Python 3.10+ | 使用安装与维护脚本时；手动复制技能不需要 |
| PyYAML | 仅维护检查需要，见 requirements-dev.txt |
没有图像生成能力时，可提供已经检查合格的九视图，或明确调整本次视图范围。安装技能不会自动安装 Blender、图像模型或第三方创作软件。
下载或克隆本仓库后，在仓库根目录运行：
python3 scripts/install.py
默认复制到用户的 ~/.agents/skills/blender-character-workflow/。同名目录已存在时，安装器停止并保留原内容；更新前自行备份和移走旧目录。安装器不会启动 Blender、联网或修改 Agent 配置。
安装器只复制 scripts/install.py 中 PACKAGE_FILES 明确列出的技能文件，排除缓存、本地配置和额外素材，并拒绝包含符号链接的源目录。全部文件先复制到临时目录，成功后再移至目标位置；失败会清理临时产物，允许修复后重试。
也可指定技能父目录，例如目标项目内的 .agents/skills，或宿主实际使用的其他技能目录：
python3 scripts/install.py --destination /path/to/your-project/.agents/skills
手动安装时，将整个 skills/blender-character-workflow/ 文件夹复制到技能目录，保留其中的 LICENSE 和原文件夹名称。
Codex 的用户与项目技能路径及发现方式见 OpenAI 官方技能文档。安装后若未显示，重新启动 Codex，并检查其他目录是否已有同名技能。
在支持 $ 技能引用的 Codex 界面中输入以下内容，并附上原图或实际工程路径：
使用 $blender-character-workflow，按照这张参考图制作头部和头发，
不要脖子和身体，用于静态多角度展示。先完成九视图参考，再继续建模。
使用 $blender-character-workflow，修复现有工程的刘海缺口和头顶 UV 拉伸。
保留当前脸型、眼睛和后发，在新版本中修改，并提供修改前后的固定视角对比。
使用 $blender-character-workflow，检查这个 blend 的贴图依赖和多视图表现。
只做只读检查，分别说明外形、工程和用途方面实际检查了什么。
准备输入时说明主参考、制作范围、用途、必须保留的特征和输出格式。目标交付包括 .blend、来自同一版本的真实渲染、必要资源和简短检查说明。
skills/blender-character-workflow/
SKILL.md 技能入口
LICENSE 随技能分发的许可证
agents/openai.yaml Codex 界面元数据
references/production-workflow.md
references/blender-reliability.md
references/static-illustration-finish.md
scripts/ 安装与仓库检查
tests/ 分发行为检查
docs/releasing.md GitHub 发布准备
详细流程从 SKILL.md 进入。技能正文目前以中文维护，英文 README 提供安装、范围与使用说明。
欢迎提交可复现的问题、流程改进和有明确授权的案例，见 贡献指南。维护检查：
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements-dev.txt
python3 scripts/validate.py
python3 -m unittest discover -s tests
上面的激活命令适用于 POSIX Shell；Windows 可使用 .venv\Scripts\Activate.ps1。GitHub Actions 运行相同检查，并用 scripts/check_whitespace.py 检查 PR 或 push 的实际提交范围；首次推送和手动运行检查整个提交树。检查范围是分发结构和安装行为，不执行人物建模。
指令、文档和辅助脚本采用 MIT License，许可证随技能一并分发。人物参考图、角色设计、贴图和外部模板的权利需单独确认；仓库许可证不替第三方素材授予使用权。
这是社区项目，与 OpenAI 或 Blender Foundation 无官方隶属关系。