Home / cheshiremew / puppetloom · GitHub

live2d-puppet SKILL.md skillA

live2d-puppet from cheshiremew/puppetloom is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add cheshiremew/puppetloom/live2d-puppet@git:20260909.4904090

Pins git:20260909.4904090 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
cheshiremew/puppetloom
Path
skills/live2d-puppet/SKILL.md
Versions recorded
5
Latest version
git:20260909.4904090, committed Sep 9, 2026
First version recorded
Aug 23, 2026
Size
21,856 bytes
Repository stars
257
License
AGPL-3.0

使用 PuppetLoom 让外部 Agent 通过 CLI 从分层角色 PSD 创建或改善可动 2D 角色，可按整模或指定部位完成分析、网格与运动制作、自检、返修和准确 revision 的证据闭环；也用于检查关键形、权重、透视、次级运动与校准结果，通过 CLI 依次演示编辑器和角色窗口的真实功能，以及直接导出 Cubism 工程和运行时文件或使用 Editor 桥接。Use when an external agent such as Codex should create or improve a PuppetLoom character through the CLI, review exact-revision visual evidence, demonstrate the real editor and runtime under CLI control, or bridge a verified project to official Cubism runtime files. 不用于在桌面应用里内嵌 Agent…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Live2D Puppet

## 目标

把角色原图、See-through 分层 PSD 和自然语言目标交给 Codex 一类外部 Agent。Agent 通过 PuppetLoom CLI 自动创建项目，再按整模或指定部位完成结构分析、网格与关键形制作、权重和物理配置、自检、局部返修及准确 revision 的视觉证据。用户主要审查角色实际效果，并用“幅度小一点”“滞后太慢”“太弹”这类结果反馈继续调整；逐点编辑只是备用能力。桌面应用是查看、播放和人工兜底工具，不承载 Agent 编排或聊天入口。默认交付仍是普通 PuppetLoom 项目。用户明确需要 Cubism 时，使用 `cubism export` 输出 `.cmo3/.moc3` 和配套文件；已有 Editor 工程的同步仍可使用官方 API 桥接。直接导出与 API 同步的限制必须分别报告。第一次结果以“合理地会动”为目标，不用十五种嘴形或未经素材支持的复杂表情；需要实时麦克风口型时，默认只使用已有闭口和一个张口状态。

## 工作方式

先使用包装脚本运行 `capabilities --json`，确认 `build.current`、实际命令和配套 Skill 身份；不要根据软件版本号猜工具是否存在。包装脚本支持 `PUPPETLOOM_ROOT` 和 `PUPPETLOOM_NODE`；复制到仓库外的 Skill 必须明确项目根。按当前结果读取对应方法，不为一次局部修形加载全部制作流程：

| 当前任务 | 读取方法 |
| --- | --- |
| 从 PSD 创建角色或更新源 PSD | `references/from-zero-workflow.md` |
| 分部制作、检查与返修 | `references/agent-review-and-repair.md`；涉及形状或运动时加读 `references/visual-rigging-rules.md` |
| 原素材闭眼、脸缘和五官的目标修形 | `references/shape-target-workflow.md`；视觉标准沿用 `references/visual-rigging-rules.md` |
| 拆发、替换头饰等通用补件，或局部关键形修形 | `references/asset-and-geometry-workflow.md`；视觉判断沿用 `references/visual-rigging-rules.md` |
| 缺原图、See-Through 分层、源图错误 | `references/source-art-and-layering.md`；明确选择本地推理时再读 `references/see-through-local-deployment.md` |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cheshiremew/puppetloom/live2d-puppet@sha256:609f77ee1880042c

The line at the top of this page pins the label git:20260909.4904090, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2jmc2damsf7xgx7l.svg)](https://markdownregistry.com/a/art_2jmc2damsf7xgx7l)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 23, 2026 and Sep 9, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20260909.4904090 latest2026-09-09 4904090 21,856 BA view · diff
git:20260828.61f7de42026-08-28 61f7de4 20,609 BA view · diff
git:20260828.597b0392026-08-28 597b039 19,929 BA view · diff
git:20260825.79c34392026-08-25 79c3439 18,163 BA view · diff
git:20260823.db5b8be2026-08-23 db5b8be 17,066 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (21856 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cheshiremew/puppetloom · 257 stars · license AGPL-3.0 · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2jmc2damsf7xgx7l
GET https://markdownregistry.com/api/v1/resolve?ref=cheshiremew/puppetloom/live2d-puppet
GET https://markdownregistry.com/api/v1/blob/609f77ee1880042c1d2b4e118ae808d5b6f812a6806fde40075219f1350161d7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

Browse by kind, by grade A, or by owner.