Pet Forge — Development skill for Claude Code
A reusable toolkit for building SVG and APNG desktop pets, with route guides, prompt templates, vectorization tools, animation conventions, and runnable demos.
How to install Pet Forge
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open rullerzhou-afk/pet-forge and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Pet Forge does
A reusable toolkit for building SVG and APNG desktop pets, with route guides, prompt templates, vectorization tools, animation conventions, and runnable demos.
Alternatives in Development
- Om Dump — Freeform capture mode 4.6k ★
- Petdex — A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and 4k ★
- Claude Code Rev — Runnable ClaudeCode source code 3k ★
README
pet-forge
用于制作自定义 SVG / APNG 桌宠的工具、模板和工作说明。
pet-forge 可以作为独立工具包使用，也可以作为 Codex skill 使用。它不是成品角色包，而是一套可复用的路线指南、prompt 模板、SVG 约定、APNG 后处理脚本、示例和状态映射说明。
路线
[SVG 路线] [APNG 路线]
参考图 prompt 模板
-> 去背景 -> AI 参考图
-> PNG 转 SVG -> 首尾帧锚定的 AI 视频
-> preset + SVG 模板 -> 纯色色键抠图
-> 自包含 .svg.html -> .apng| 主题 | SVG 路线 | APNG 路线 |
|---|---|---|
| 成本 | 本地环境装好后免费 | 使用免费或付费生成 API |
| 可控性 | 高，每个关键帧都能改 | 较低，重跑很常见 |
| 循环 | 精确 CSS 循环 | 依赖首尾帧锚定 |
| 文件大小 | 通常较小 | 通常数百 KB 或更大 |
| 适合 | 清晰矢量桌宠、小运行时文件 | 丰富视觉风格、快速草稿 |
如果你想要精确循环、小文件和可编辑动画逻辑，选 SVG。
如果你想快速探索丰富视觉风格，并且能接受生成 API 和后处理，选 APNG。
作为 Codex Skill 使用
本仓库包含 `SKILL.md`，因此 Codex 可以在规划或制作 SVG / APNG 桌宠资产时把 pet-forge 当作 skill 使用。这个 skill 会把 Codex 引导到仓库里的路线文档、模板、工具、示例和约束，而不是把任务当成从零生成。
当你希望 Codex 帮你选择路线、把透明 PNG 转成 SVG、准备 APNG 生成 prompt、把生成视频后处理成 APNG，或接一个小型可运行 demo 时，可以使用它。
先做角色拓扑盘点
在套用头部、附属结构、嘴巴或身体约定之前，先盘点角色真实拥有什么结构。不要默认每个桌宠都有完整的头、身体、手脚和嘴巴。
flowchart TD
A["概念图 / 透明 PNG / 初始 SVG"] --> B["询问角色拓扑"]
B --> C["主体形态：只有头、头+身体、软团/物件，还是其他轮廓？"]
B --> D["脸部：眼睛、嘴巴、腮红、表情符号？"]
B --> E["附属结构：手、脚、耳朵、尾巴、触角、道具？"]
B --> F["支撑关系：接地、悬浮、贴边，还是由道具支撑？"]
B --> G["需要的动作：视线方向、表情、走路、挥手、弹跳、漂浮？"]
C --> H["只为角色需要的结构建立合同"]
D --> I["有脸部 / 嘴巴结构时才建 face plane / mouth rig"]
E --> J["只为真实存在的附属结构建立锚点"]
F --> K["按需要选择身体轴、重心、接触线或悬浮锚点"]
G --> L["读取对应 SVG convention 文档"]
H --> M["工程化母版：图层、id、origin、验证"]
I --> M
J --> M
K --> M
L --> M例如：只有头的角色可能需要 face plane 和表情规则，但不需要脚部 rig；软团角色可能需要轮廓轴、悬浮锚点和 squash 规则，但没有嘴巴；完整吉祥物可能同时需要脸部、身体、附属结构和表情合同。
演示：同一张参考图，两条 SVG 路线
用同一张参考图，对比 pet-forge 两种得到 SVG 的方式：工具路线（png2svg + vtracer 追踪），和直接交给 GPT-5.5 Pro 生成。
