菜单
Add or edit sheet_definitions JSON for items, categories, variants, credits, layers, or z-positions. Use when adding art, a new category, a credits entry, or renaming an asset. Copy a neighboring definition; do not invent keys.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/LiberatedPixelCup/Universal-LPC-Spritesheet-Character-Generator --skill sheet-definition命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Run and read unit-test coverage for this repo and satisfy the codecov/patch and codecov/changes gates. Use when a PR check fails on coverage, after editing gated production code under sources/ or scripts/, or when the user mentions coverage, Codecov, patch, or uncovered lines.
Thread CatalogReader and State through Mithril attrs, never a hidden global. Handle Result/LoadError, seed test catalogs, and keep URL hashes stable. Use when adding or editing a component, a browser spec, or sources/state/ code, or when the user mentions catalog, state, hash, or aliases.
Diagnose missing or stale dist/*-metadata.js, the Vite metadata plugin cache, and the ../name-metadata.js import alias. Use when dist/ is missing, a catalog resolves nothing, a spec fails only locally, or editing the Vite metadata plugin. Do not hand-edit dist/ or add another metadata module.
基于 SOC 职业分类
| name | sheet-definition |
| description | Add or edit sheet_definitions JSON for items, categories, variants, credits, layers, or z-positions. Use when adding art, a new category, a credits entry, or renaming an asset. Copy a neighboring definition; do not invent keys. |
Copy a neighboring JSON under sheet_definitions/. Do not invent a schema.
Accepted fields: SheetDefinition in
scripts/generateSources/items.ts.
Human walkthrough and the credits example:
CONTRIBUTING.md.
Multi-layer example: tail_lizard.json.
Typical required keys: name, type_name, layer_1 (zPos plus body-type
paths into spritesheets/), and credits[] (file, authors, licenses,
urls; notes is optional).
type_name is the hash key and name supplies the Item half of the
Item_variant hash value, so both are part of the URL contract — see
catalog.
credits[].file must name the spritesheet file or one of its path-segment
ancestors, not an arbitrary string prefix. searchCredit in
credits.ts matches
credit.file against the path exactly, against path + ".png", or against
credit.file + "/", then retries after trimming at the last /. So
arms/hands/ring covers arms/hands/ring/stud, but arms/hands/ri covers
nothing. Failing to match logs missing credit after searching recursively
and then throws missing credit inside ….
Existing category: add PNGs under spritesheets/ and the variant name on
the matching definition (variants). Palette-backed items use recolors and
do not add a PNG per color — follow
Adding Palette Support,
do not invent recolors keys.
New category: new JSON next to similar items.
Optional: animations restricts the animations filter; omit it for the
default list. Asset renames need aliases on the destination definition
and an issue first. Other keys (tags, replace_in_path, match_body_color,
…) — copy a neighbor that already uses them.
Then npm run validate-site-sources and commit any dirty CREDITS.csv /
z_positions.csv. CREDITS.csv is generate-only. z_positions.csv may be
edited as a bulk aid; JSON is the source of truth
(npm run z-positions:update writes the CSV back to JSON). The app reads
generated dist/*-metadata.js, not the JSON directly; if a new item is
invisible after npm run dev, see
generated-metadata.
