SkillFoxx

CXP Character Forge skill

A skill that takes one character sheet to a 3D model that dances in MMD: generation, rig, textures, faces, physics, render.

  • 69 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • Scripts run on the computer and generation spends paid quota of the chosen proxy service.
  • The service key lives in a file the configuration points to.
All reasons and checks

cxp-2024/cxp-character-forgeAuthor:CXP-2024

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/cxp-character-forge

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Scripts run on the computer and generation spends paid quota of the chosen proxy service.
  • The service key lives in a file the configuration points to.

This is third-party code. Review the repository files before installing.

What it does

CXP Character Forge walks an agent through the whole path of building a character for MMD dances. The input is a character design sheet. The skill prepares a T-pose sheet, generates a model through a Tripo-compatible proxy, splits it into components, builds a rig and checks it with a simple dance, retextures components, makes eyes, mouth and expressions, tunes cloth and hair physics, applies MMD motion and hands over a finished render. The process comes from a real project, from a sheet to a full-song duet. The author says plainly that it is not a one-click generator and states which steps are done and which need human supervision. At every stage the result is compared with a reference on a grey model under the same camera, original assets stay read-only and edits are saved as new versions.

Who it is for. 3D artists and MMD video makers who build characters from a sheet and want to hand the routine to an agent.

Good fit when

  • A design sheet exists and you need a model from it with a working MMD rig.
  • Clothes and hair need physics and a skirt has to be simulated in layers.
  • A model is generated and has to be split into head, hair, accessories and skirt.
  • A generation task was interrupted and must be resumed without resubmitting.

Not a fit when

  • You want a model in one click with no human at the checkpoints.
  • You lack Blender 5.2, Python 3.10 or access to a Tripo-compatible proxy.
  • The work involves someone else's intellectual property: check rights before using characters.

Example request

Build a model from this sheet that can dance in MMD: start with a grey model check and a split into components.

Limitations

Needs Python 3.10 and Git, Blender 5.2 with `mmd_tools`, Node.js 22 for Charakuru, a Tripo-compatible proxy with your own key and Houdini for cloth physics. The Houdini licence is machine-bound: one licence works on one computer at a time. The adapter targets proxies with a `/v1` path and does not connect to the official `/v3`. Generation spends service quota at the service price. The repository has no licence file.

How to disable. Delete the `~/.claude/skills/cxp-character-forge` or `~/.codex/skills/cxp-character-forge` folder. Remove the `proxy-config.json` file with the proxy address and the key file separately.

FAQ

How do I install the skill in Claude Code?

Run `git clone https://github.com/CXP-2024/cxp-character-forge.git ~/.claude/skills/cxp-character-forge`, then `python scripts/bootstrap.py` in that folder.

How do I install it for Codex?

Clone into `~/.codex/skills/cxp-character-forge` and run `python scripts/bootstrap.py`. Explicit call: `$cxp-character-forge`.

How do I check the setup without spending quota?

`python scripts/tripo_proxy.py doctor` checks configuration offline, and `doctor --online` only reads and submits no tasks.

What should be installed alongside?

The README suggests Charakuru, `genshin-blender-render`, `codex-image-gen-skill` and skills for cloud GPU rendering of long videos.

Is it a one-click generator?

No. The author names the steps that need a person, and each stage result is compared with a reference.

Discussion

No questions or reviews yet.

Skills

A skill pack for 3D characters from illustrations: input prep, rigging, expressions and checks in Blender.

SkillMinimal access64

A Codex skill that builds an original photorealistic character from a brief: face, age, wardrobe, extra angles on request.

SkillExtended access143

A skill that turns your photo or description into a hand-drawn character and uses it for diagrams, knowledge cards and slides

SkillExtended access269

A skill rebuilds the object in a reference image as a procedural Three.js model written in code, not downloaded art

SkillMinimal access21.3K

A loop skill: the agent generates a target screenshot, builds toward it, and uses a critic subagent to close the gap until they match

SkillExtended access2K

A skill for Live2D projects: from layers and Cubism rigging to browser acceptance and rollback, with code and a sample model.

SkillExtended access115

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialRepository starsMain difference
CXP Character Forge (this card)no69
Blender Agent Skillsno1,014Blender skills for modelling and animation across 3D assets; this is a chain from a character sheet to an MMD dance
design-os-3d-blenderno115a plugin for precise parts through `bpy`; this one builds an anime character with a rig, expressions and cloth physics

README in short

The repository holds the entry `SKILL.md`, stage references with acceptance criteria and scripts for the proxy client, component retexturing, eye refinement and Houdini skirt solving. The author suggests installing related render and image-generation skills alongside.

README badge

Original SKILL.md

---
name: cxp-character-forge
description: 从参考立绘通过 Tripo 兼容代理生成带贴图的 3D 人物，接续 Blender 外形检查、组件修整、按需绑骨动作与资产交付。用于人物建模和已有生成任务续作。
---

# CXP Character Forge

使用本 skill 目录下的 `scripts/tripo_proxy.py`。首次安装执行 `python scripts/bootstrap.py` 获取固定版本依赖；读取 README 的配置方式。只向用户配置的代理地址发送密钥，不调用上游官方 CLI 的 configure。

## 任务与参考

尊重用户确认的设计、比例、定稿版本与静态/动画用途。先查已有资产和任务记录，避免重复生成。造新人物先确认本机装有 [Charakuru](https://github.com/nanocle/Charakuru) 源码（Releases 下载解压；Node 22+、Blender 5.2、VRM Add-on），作为三视图、重贴图分组、UV 恢复、权重迁移、表情与摇摆物理的方法库，见 [Charakuru 方法](references/charakuru-methods.md)。推荐路线：T 型正背设定图 → **整体一次生成**（每次只调用 1 个任务，不并行、不抽卡，非常耗积分）→ 灰模与网格检查，当场试拆头、头发/刘海、饰品、裙子（拆不开就改图重生成）→ 快速绑定并套一段简单 MMD 动作校验骨架，让 AI 修骨骼节点和权重 → Tripo 重贴图并转回 UV（最耗时）→ 表情 → 最后做物理；制作期间二次元角色默认用原神式快速三渲二材质加灰模检查（渲染快、方便迭代），最后一步才用 [genshin-blender-render](https://github.com/CXP-2024/genshin-blender-render) 做精细渲染；眼睛、嘴部和表情三样缺一不做：Charakuru 方法论、目标原脸型不变、参考角色的完整表情网络与贴图（含口腔结构），见 [表情前提](references/facial-expressions.md)、[眼眉流程](references/eye-brow-expression-workflow.md)；**不要把头和身体分开生成**（颈部接缝、比例、肤色难以接上，这点与 Charakuru 原版不同）。步骤、经验与 MMD 细节见 [人物流程](references/character-workflow.md)；组件拆分清单和每个组件该用 Tripo / Codex 投影 / 几何生成 / 平涂见 [分组件贴图](references/component-texturing.md)，脚本在 `scripts/component_tex/`。与 MMD / 原神 PMX 角色同框时的眼睛精细化（眼白上睑阴影、分层瞳孔、发光闪点）见 [眼睛精细化](references/eye-refinement.md)，脚本在 `scripts/eye_refine/`。Houdini 无界面裙发解算见 [houdini-cloth-hair](references/houdini-cloth-hair.md)；整首分段解算、已认可段只解后段拼接、真实多层裙解算（层间缝合、裙撑、灰模验收）、远端 Linux 安装、授权按机器占用的规则与分块整理见 [houdini-fullsong-remote](references/houdini-fullsong-remote.md)，脚本在 `scripts/houdini_song/`。

先核对 A/T 姿态、头身比例、手指、前后轮廓与遮挡。多视图必须同角色同姿态；不可靠侧背图不应强行参与生成。隐藏面属于补全假设。

## 生成与恢复

- `doctor` 离线检查配置；`doctor --online` 只读验证；`models`、`balance` 查询模型与余额。配置服务兼容约定见 [代理 API](references/proxy-api.md)。
- 获取当前模型 value、支持参数和价格，不把历史型号或代理参数当作官方通用规格。已有制作授权内可执行生成；仅连接测试不要提交付费任务。
- 优先带原生纹理生成，尽早查看真正的贴图模型。灰模用于辅助诊断，不能代替带纹理检查。
- `upload --file reference.png --record uploads/front.json` 上传参考；将返回 token 与当前 model value 填入 examples/image-to-model.json 的副本。
- `submit --request request.json --job jobs/v1 --dry-run` 离线校验后，使用同命令 `--execute` 提交。
- `wait --job jobs/v1 --timeout 45`，退出码 3 表示继续等待；成功后 `download --job jobs/v1 --extract`。
- 同请求复用 job；改参数用新目录。POST 结果未知时先对账再 recover，不盲目重提。原生下载与收费格式转换要区分。

## Blender 验收

保留原始生成文件，在副本中修整。渲染真实模型正面、侧面、背面与旋转检查，不能把二维生成图当模型效果。检查手指、面部、贴图接缝、发根、头饰、尾巴体积与连接、翼根和手臂穿插。

保持用户认可的原生贴图与五官比例；三渲二无法修复错误几何或烘焙在贴图中的污染。局部替换需三维贴合与侧面验收，不能只看正面投影。尾巴/头发等组件需有连续根部和适当厚度。

静态交付无需强行绑骨。需要动画时执行 prereigcheck → rig → flags/animations → retarget，检查真实变形。MMD 表情、骨骼映射及衣发物理单独制作与验证；两个独立生成头不能直接视为连续眨眼形态键。

## 交付

按人物与版本组织定稿目录，Blender 贴图内嵌或完整相对路径，按需提供 GLB、真实渲染和旋转视频。报告完成阶段、已检查角度和剩余问题。用户只要模型包时，不夹带视频/过程文件；只报告实际验证过的动画能力。

离线回归：`python scripts/test_proxy.py`。脚本检查接口行为，不证明生成质量、蒙皮或物理通过。

原生嘴型迁移、VMD 表情轨道接入及嘴周碎片/肤色问题，见 [嘴型迁移与修复](references/mouth-transfer-vmd-repair.md)。

Report a problem