spritekiln — правило для Claude Code: что делает и установка
Правило spritekiln для Claude Code задаёт работу со спрайтами SpriteKiln из YAML-спецификаций. Оно включается для файлов specs/**/*.yaml.
MIT ★ 177 обновлён 2026-11-12
.cursor/rules/spritekiln.mdcЧто делает spritekiln
Правило spritekiln задаёт процесс создания и правки спрайтов SpriteKiln по YAML-спецификациям. В спецификации описываются скелет, SDF-примитивы, материалы, палитра и анимации, а результатом становятся 8-направленная пиксельная графика, атлас, JSON и normal/emissive maps.
Перед работой с ассетом агент читает docs/agent/workflow.md, docs/agent/style.md и docs/agent/spec.md, а дополнительные шаги берёт из документов о моделировании, анимации и арт-дирекшене. После каждой правки запускается spritekiln validate <spec>, для проверки поз используется spritekiln pose <spec> --dirs all, а итоговый рендер выполняется через spritekiln render.
Сначала в сессии запускается spritekiln style; если стиль не записан, его фиксируют по вопросам из docs/agent/style.md. Файлы в out/ генерируются автоматически и не редактируются вручную. Для экспорта нужен движок, настроенный в spritekiln.toml; через MCP-клиент доступен spritekiln mcp.
Какие задачи решает
- описать спрайт через YAML-спецификацию
- проверить спецификацию после правки
- просмотреть позы по всем направлениям
- оценить движение анимационного клипа
- передать рендер в игровой движок
Примеры запросов агенту
- Создай спрайт по спецификации
specs/hero.yamlи соблюдай стиль проекта. - После правки
specs/hero.yamlпроверь её и покажи изменившиеся направления. - Проверь движение клипа
walkвspecs/hero.yaml, затем подготовь итоговый рендер.
Как установить spritekiln
Вручную: положить файлы
.cursor/rules/spritekiln.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/spritekiln.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/spritekiln.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/spritekiln.mdВручную: положить файлы
.clinerules/spritekiln.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о spritekiln
Как установить spritekiln в Claude Code?
Добавьте файл правила по пути .claude/rules/spritekiln.md.
Что делает spritekiln?
Правило задаёт работу со SpriteKiln-спрайтами через YAML: от описания скелета, материалов и анимаций до проверки поз, рендера и экспорта.
Что нужно для работы spritekiln?
Нужен SpriteKiln с командами spritekiln style, spritekiln validate, spritekiln pose и spritekiln render. Для экспорта используется движок из spritekiln.toml, а операции через MCP доступны после запуска spritekiln mcp с MCP-клиентом.
Исходный текст
spritekiln.mdc · MIT
--- description: Making and editing SpriteKiln sprites (YAML specs -> 8-direction pixel art) globs: specs/**/*.yaml alwaysApply: false --- ## SpriteKiln assets Sprites in this project are made with SpriteKiln: a YAML spec (skeleton, SDF primitives, materials, palette, animations) is rendered into animated 8-direction pixel art (atlas + JSON + normal/emissive maps). Read before working on an asset: `docs/agent/workflow.md` (commands and the working loop), `docs/agent/style.md` (the project's art style) and `docs/agent/spec.md` (the spec format). Then, as needed: `docs/agent/modeling.md`, `docs/agent/splash-to-model.md`, `docs/agent/animation.md`, `docs/agent/art-direction.md` and `docs/agent/recipe.md` (the modeler → art director → animator recipe). Rules that matter: - Art style first: run `spritekiln style` before the first asset of a session. If no style is recorded, interview the user with the questions of `docs/agent/style.md` and record the answers before generating anything. Follow the recorded style in every asset; change it only when the user explicitly asks. - Run `spritekiln validate <spec>` after every edit; problems come with file:line:column. - Iterate with `spritekiln pose <spec> --dirs all` (about 1 s per direction); `spritekiln render` only at the end. After an edit to a model you have already seen whole, `--changes` shows only the directions that changed. - Tie each `must_keep` trait of the `brief` to its parts in `review.keep`: QA then says where it stops reading. - Judge a clip's motion on `spritekiln arcs <spec> --anim <clip>` before its contact sheet. - A character's head and hair are decided in its `brief.head` and judged up close with `spritekiln pose <spec> --focus head --dirs all`: on a normal preview a face is a few pixels. - Never call something visual good without looking at the PNG. If you cannot see images, use the numbers of `spritekiln review` (value, contrast, pixels per material, IoU) and `qa.json`. - Keep the camera pitch, light and `camera.scale` shared by every asset of the game. - Outputs under `out/` are generated: never edit them. - `spritekiln export <spec>` hands a render to the engine configured in `spritekiln.toml`. - With an MCP client, `spritekiln mcp` serves these operations as tools that return images and JSON.
© LucasJRamos · MIT · LucasJRamos/spritekiln