К основному содержанию
скилл CX Codex

pxforge-splash-to-model — скилл для Claude Code: установка и обзор

Скилл pxforge-splash-to-model для Claude Code переносит концепт-арт персонажа в YAML-модель SpriteKiln. Включается, когда вы даёте арт героя и просите подготовить модель, спрайт или анимации.

MIT ★ 177 обновлён 2026-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add LucasJRamos/spritekiln --skill pxforge-splash-to-model -a claude-code
Открыть на GitHub

Что делает pxforge-splash-to-model

Скилл превращает арт или концепт персонажа в файл спецификации SpriteKiln с палитрами и костями. Спрайт строится читаемым в разрешении 64 пикселя в восьми направлениях. Процесс начинается с подготовки референса через python -m pxforge ref prep, отделения фона и составления текстового описания силуэта и ключевых черт в секции brief.

Дальше агент настраивает палитру, делает базовый блокаут по шаблону и сравнивает силуэт через python -m pxforge ref compare. На сравнении с поправкой на наклон камеры агент доводит метрику IoU минимум до 0.65. Затем подключаются готовые наборы деталей для головы, причёсок и экипировки, после чего генерируются обзорные листы в восьми ракурсах.

Для работы требуются Python и утилита pxforge. Для артов с пёстрым фоном понадобится пакет rembg, который ставится через экстра splash.

Какие задачи решает

  • перенести 2D-арт персонажа в модель SpriteKiln
  • подобрать читаемый силуэт спрайта 64 px в 8 направлениях
  • выделить цветовую палитру героя из концепт-арта
  • сравнить пропорции модели с референсом через метрику IoU

Примеры запросов агенту

  • Вот арт мага mage_splash.png, собери по нему модель персонажа в SpriteKiln
  • Сделай спрайт героя на основе concept.png для 8 направлений в 64 px

Как установить pxforge-splash-to-model

1Через Skills CLI (Vercel)

npx skills add LucasJRamos/spritekiln --skill pxforge-splash-to-model -a claude-code

2Вручную: положить файлы

~/.claude/skills/pxforge-splash-to-model/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pxforge-splash-to-model/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pxforge-splash-to-model

Как установить pxforge-splash-to-model в Claude Code?

Выполните команду npx skills add LucasJRamos/spritekiln --skill pxforge-splash-to-model -a claude-code. Второй вариант — вручную положить файл в ~/.claude/skills/pxforge-splash-to-model/SKILL.md.

Что делает pxforge-splash-to-model?

Переводит плоский концепт-арт в спецификацию SpriteKiln, проверяет совпадение силуэтов и готовит спрайт к рендеру в восьми направлениях.

Что нужно для работы pxforge-splash-to-model?

Нужны установленный Python с модулем pxforge. Для автоматического удаления сложного фона на иллюстрациях требуется пакет rembg, доступный через установку с флагом splash.

Исходный текст

SKILL.md · MIT
---
name: pxforge-splash-to-model
description: Turn an original splash or concept art into a SpriteKiln model (spec YAML) faithful to the art and legible at 64 px in 8 directions. Use when the user provides a character image and asks for its model, sprite or animations. (Folder name kept for projects that link to it; same as the spritekiln skill.)
---

# From a splash art to a model

Goal: capture the character's **identity** (silhouette, proportions, striking shapes, palette), not the
brush strokes. At 64 px only what is big and contrasted survives. Read [workflow.md](workflow.md),
[modeling.md](modeling.md) and [spec.md](SPEC.md) first.

## 1. Prepare the reference
```
python -m pxforge new <name> --extends --ref <path/splash.png>   # <specs>/characters/<name>/ with splash.png; a humanoid
                                                      #    extends the template (drop --extends to copy it)
python -m pxforge ref prep <specs>/characters/<name>/splash.png    # -> splash_ref/: cutout.png, cutout_pitch38.png,
                                                      #    palette.yaml, ref.json (proportions)
```
- Look at the original splash **and** `cutout.png`. The background is removed from the border inwards, so
  flat, gradient and vignetted backgrounds work, and openings such as the gap between the legs stay
  transparent. If it cut wrong: try `--tol` 4–15 (colour step, default 9), ask for a PNG with
  transparency, or install the `splash` extra (rembg) for busy backgrounds.
- Decide which **direction** the art shows (front = `s`, 3/4 front = `se`/`sw`, profile = `e`/`w`).

## 2. Write the brief (top of the spec)
Before any geometry, fill `brief:` while looking at the image:
```yaml
brief:
  summary: one sentence on who this is and how they carry themselves
  reference: splash.png (seen from se)
  proportions: "head = 1/4 of the height; shoulders 1.6x the hips; short legs"
  head: "high ponytail past the shoulders, side-swept fringe, soft jaw, pointed chin; eyes only (face: minimal)"
  must_keep: [3-6 traits that identify the character from afar]
  simplify: [what will vanish or merge at 64 px]
  palette_notes: [dominant materials and colours]
```
At most 5–6 `must_keep`. Small ornaments become a colour spot or vanish. Exaggerate what is iconic (hat,
weapon, hair, cape): at 64 px, exaggeration is fidelity. The head is never a detail to drop: with stylized
proportions it is about a fifth of the sprite. `head` says what the splash's hair and face are, in the terms
of the head and hair kits, and how much face the project's style (`face`) shows.

## 3. Palette
`splash_ref/palette.yaml` has colour families with hue-shifted ramps ready (`fam1`, `fam2`...). Copy it to
the project's palettes folder as `<name>.yaml`, **rename** the ramps (skin, cloth, hair, metal...), drop
background or noise families and merge near-identical ones. Adjust with
`python -m pxforge palette ramp "#hex" --steps 5`. 3–6 materials plus one emissive is ideal. In the spec:
`palette: [gothic, ../../palettes/<name>.yaml]` (gothic brings the `fx_*` ramps and basics).

## 4. Blockout
Start from a template (`humanoid`, or `side_humanoid` for a side view) or a similar spec. Over a base, give
only the keys that change (`bones: {torso_rot: {pos: ...}}`, `ik: {leg_L: {lengths: [...]}}`):
1. **World scale:** total height 1.6–2.0; adjust the pelvis height (`torso_rot.pos`) and the IK lengths.
2. **Big masses:** torso, hips and legs as ellipsoids and cones; the head's size with the `head` bone
   scale (its shape and the hair come in step 5).
3. `pose --dirs all` and `ref compare <spec> <splash> --dir <dir>`.
4. Iterate until the **camera-corrected IoU ≥ 0.65** in the art's direction and no band hint is large.
   Each silhouette is scaled to its own bounding box, so a hat tip, a raised weapon or a flared hem moves
   the whole comparison: when an extremity changes, read the overlay on the sheet, not only the number.
   `ref compare` squashes the splash by cos(pitch) like the game camera sees a front view; against the raw
   splash the IoU tops out near 0.56, so do not chase raw numbers. The hints say at which height the sprite
   is too wide or too narrow: fix the part at that height. Do not chase IoU above ~0.85; the splash has its
   own perspective and pose, and legibility matters more.

## 5. Striking shapes and materials
First the **head and the hair**, as `brief.head` says: fit the `head` kit (`jaw`, `chin`, `width`) and a
hair kit (`hair`, `ponytail`, `bun`) with their params, or model them yourself ([modeling.md](modeling.md),
"Heads, faces and hair"). Look at them with `pose --focus head --dirs all` next to the splash's face.

Then one `must_keep` at a time (horns = `tube`), adding its entry to `review.keep` as you go
([spec.md](SPEC.md): the parts or materials that show the trait, and the directions where it must). A weapon, shield, helmet, hood, hat, cape, belt or pouch
starts from a kit (`spritekiln kits`; `use:` with its params, recoloured through materials); model your own
only when no kit comes close. After each one: `pose --dirs all`. Check the **8 directions**, not only the
art's; invent what the splash does not show, coherently, and record the decision in `brief`.

## 6. Final comparison and review
```
python -m pxforge ref compare <spec> <splash> --dir <dir>          # -> out/compare_<dir>.png + .json
python -m pxforge review <spec> --ref <splash> --ref-dir <dir> [--bg <game floor>] [--tint <scene light>]
```
Open the comparison sheet (reference | sprite | silhouette overlay | 8 directions | palettes) and the review
sheet. `ref compare` also says where the sprite's colour departs from the splash's at the same height ("bands
20-30% to 40-50%: render #2a2f3a is much darker than the reference #8a2030"): a coat in the wrong colour, a
sprite far darker than the art. A splash is painted under its own light, so treat these as places to look, not
numbers to match. Then an art-direction pass ([art-direction.md](art-direction.md)); apply the high-priority
fixes.

## 7. Animate
With the model approved, follow [animation.md](animation.md). The personality of the splash (heavy, agile,
arrogant) must show in the idle and in the timing of the attack.

## Pitfalls
- A splash with a dynamic pose (raised leg, raised weapon): compare against a similar animation frame
  (`--anim attack --frame 2`) instead of the rest pose.
- A cropped splash (no feet): the IoU is meaningless; compare only the proportions of the visible part and
  say so.
- A weapon bigger than the body: keep it out of the comparison (note it in the brief) and check margins in
  QA.

## More
Reference files in this folder: [workflow.md](workflow.md), [style.md](style.md), [SPEC.md](SPEC.md), [modeling.md](modeling.md), [animation.md](animation.md), [art-direction.md](art-direction.md), [recipe.md](recipe.md).

© LucasJRamos · MIT · LucasJRamos/spritekiln

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
layer-pixel-art layerai Скилл layer-pixel-art для генерации пиксель-арта в Layer: спрайты, тайлы, циклы ходьбы и сборка кадров в спрайт-лист. Помогает, когда картинка выходит размытой или не по сетке. CX Codex +1 5 100установок pixel-art-sprites omer-metin Скилл pixel-art-sprites настраивает ассистента на отрисовку спрайтов и тайлсетов. Пригодится при разработке ретро-игр с жёсткими лимитами палитры и кадров. CX Codex +1 3 300установок game-assets Meowa-AI Скилл game-assets готовит игровые ассеты и дизайн-документы для проектов на TypeScript/Three.js: спрайты, тайлсеты, карты, звук и озвучку через Meowa CLI. CX Codex +1 1 400установок scenario-side-view-game-kit scenario-labs Скилл scenario-side-view-game-kit генерирует спрайт-листы и многослойные фоны для 2D-платформеров через Scenario с локальной сборкой кадров. CX Codex +1 691установок pixel-art omer-metin Скилл pixel-art для Claude Code и других агентов: палитры, дизеринг, субпиксельная анимация, тайлы и ограничения ретро-железа. Даёт знания для работы со спрайтами и тайлсетами. CX Codex +1 629установок Pixel Art Creator willibrandon Скилл Pixel Art Creator для Claude Code создаёт пиксельные спрайты с нуля — холст, слои и базовые фигуры через MCP-сервер Aseprite. Создаёт спрайты, иконки и тайлы без графического редактора. CX Codex +1 1установок

Из того же набора10

Весь набор →
animator Субагент animator для Claude Code создаёт и дорабатывает SpriteKiln-анимации. Инструмент автоматически применяет тайминги, учитывает антиципацию и проверяет переходы в восьми направлениях. CX Codex ★ 177звёзд репо character-modeler Субагент character-modeler для Claude Code моделирует персонажей, монстров и пропы в SpriteKiln по брифу или splash art. Сверяет силуэт в 8 направлениях. CX Codex ★ 177звёзд репо pixel-art-director Субагент pixel-art-director для Claude Code оценивает спрайты и анимации SpriteKiln перед финализацией ассета. Он проверяет силуэты, контраст и лица, выдавая список правок без изменения файлов. CX Codex ★ 177звёзд репо spritekiln-splash-to-model Скилл spritekiln-splash-to-model для Claude Code превращает изображение персонажа в спецификацию SpriteKiln. Он включается, когда нужно собрать модель, спрайт или анимацию по концепт-арту. CX Codex +1 ★ 177звёзд репо spritekiln-animation spritekiln-animation — скилл для Claude Code, который помогает создавать и настраивать анимации по спецификации SpriteKiln. Он задаёт движение для пиксельных персонажей в восьми направлениях и размечает игровые события. CX Codex +1 ★ 177звёзд репо pxforge-animation Скилл pxforge-animation для Claude Code настраивает 8-направленную пиксельную анимацию в спецификациях SpriteKiln. Он рассчитывает тайминги кадров, антисипацию, циклы и игровые события. CX Codex +1 ★ 177звёзд репо spritekiln Скилл spritekiln для Claude Code создаёт и редактирует персонажей, монстров и предметы в виде анимированных пиксельных спрайтов с восемью направлениями. Перед первым ассетом проекта агент уточняет художественный стиль. CX Codex +1 ★ 177звёзд репо pxforge Скилл pxforge для Claude Code генерирует и правит персонажей и пропсы в виде анимаций в восьми направлениях через SpriteKiln. CX Codex +1 ★ 177звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой