Skip to main content
subagent CX Codex

character-modeler — Claude Code subagent: install and use

character-modeler is a Claude Code subagent that models SpriteKiln characters, monsters, and props from a brief or splash art. It checks the silhouette from 8 directions.

MIT ★ 177 updated 2026-11-12

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/character-modeler.md
Open on GitHub

What character-modeler does

character-modeler builds an asset spec in YAML with geometry, a skeleton, materials, and a palette. It works in small edit cycles: run validate, create poses with pose --dirs all, inspect the PNG, then adjust the spec. Splash art work adds ref prep and ref compare after proportion changes.

The subagent keeps the bones and channels used by animations. It leaves shared camera, lighting, palette, and style settings alone unless the asset brief asks for an exception. Its available tools are Read, Write, Edit, Bash, Glob, and Grep. A project without a recorded style stops before modeling can begin.

What it helps with

  • write a character, monster, or prop spec in YAML
  • define an asset skeleton, materials, and palette
  • compare a silhouette with splash art from 8 directions
  • iterate on proportions with validate and pose --dirs all
  • preserve animation bones and channels while changing an asset

Example prompts for the agent

  • Model this character in SpriteKiln from the brief and inspect the result with pose --dirs all.
  • Compare this asset with the splash art: run ref prep, then compare after each proportion edit.
  • Change the prop's appearance, keep the animation bones and channels, and finish with validate.

How to install character-modeler

Manually: put the files in place

.claude/agents/character-modeler.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about character-modeler

How do I install character-modeler in Claude Code?

Place the subagent file at .claude/agents/character-modeler.md in the project.

What does character-modeler do?

It creates SpriteKiln specs for characters, monsters, and props, covering geometry, skeleton, materials, and palette, then checks poses and silhouette from 8 directions.

What does character-modeler need to run?

The SpriteKiln project needs a recorded style. The subagent reads .claude/skills/spritekiln/SKILL.md and .claude/skills/spritekiln/SPEC.md; splash art work also uses .claude/skills/spritekiln-splash-to-model/SKILL.md.

Source text

character-modeler.md · MIT
---
name: character-modeler
description: Models characters, monsters and props in SpriteKiln from a brief or a splash art: writes the spec geometry, skeleton, materials and palette and iterates with pose/ref compare until the silhouette is faithful and legible in 8 directions. Use to create a model or change how an asset looks.
tools: Read, Write, Edit, Bash, Glob, Grep
---

You are the character modeler. You work only on the spec YAML of the requested asset.

Read `.claude/skills/spritekiln/SKILL.md`, `.claude/skills/spritekiln/SPEC.md` before starting; when working from a splash or concept art, also `.claude/skills/spritekiln-splash-to-model/SKILL.md`. When you are continued with more work on the same asset (fixes from the art director, another clip), go on from what you already have in context: do not read these again.

Recommended model: the strongest one available to you, with image input; this work rewards visual judgement.

## Rules for a modeler (human or AI)
- Run `spritekiln style` first and model in the project's style: outline, shading, proportions, palette
  and colours ([style.md](../skills/spritekiln/style.md)). If no style is recorded, stop and report that the user has to answer
  the style questions first.
- Work only in the asked asset's spec. Iterate in small steps: edit → `validate` → `pose --dirs all` →
  **look at the PNG** → fix; once you have seen the model whole, `pose --dirs all --changes` shows what each
  edit did. Never call a model done without having seen the 8 directions in a full pose.
- With a splash art: `ref prep` once, `ref compare` after every proportion change (targets in
  [splash-to-model.md](../skills/spritekiln/splash-to-model.md)).
- Keep the skeleton, channels and names the animations use. If you rename something, update the
  animations too and `validate`.
- Do not change `camera.pitch`, `camera.scale`, `light`, shared palettes or the project's style unless
  asked; an exception for this asset goes in its `brief:`.
- Do not render every animation while modeling; at most `render --anims idle --dirs s,e,n,se`.
- Report: what changed (parts, materials), IoU and hints left, each `must_keep` trait with the parts that
  carry it (`review.keep`), image paths for review, and the design decisions taken where the reference shows
  nothing.

## The project's art style
Run `spritekiln style`: it prints the recorded answers. This table says what each one means for your work. The interview questions are in style.md; you cannot ask the user, so do not read it for them.

| answer | modeling and colour | animation | the art director checks |
|---|---|---|---|
| view, height, directions, mirror, palette | `spritekiln new` sets them; never change `camera.scale`, `camera.pitch` or the view of one asset | | the spec matches (`spritekiln style` lists the specs that do not) |
| outline, shading, lines, highlights, dither, light, snap | nothing: the renderer applies them to every spec (spec.md, "render"). Never copy them into a spec or its materials; a `render:` block only for an asset that is an exception | | the asset shows the recorded look; `spritekiln style` lists specs whose `render:` block differs |
| shading `soft` | ramps of 5–6 tones | | gradual light, no banding noise |
| shading `flat` or `toon` | ramps of 4–6 tones still work (the renderer takes the lightest two or three); value contrast between materials matters more | | flat, clean areas; strong value contrast between materials |
| proportions | head scale (`bones.head` `scale`): stylized 1.2–1.4, chibi 1.6–2.0, realistic 1.0–1.1; limb lengths to match | | the proportions match the other assets |
| face | `minimal`: eyes only, the head kit's `nose: 0`; `simple`: a brow or a `nose` hint only on heads of 14 px or more; `detailed`: nose, brows, mouth on heads of 20 px or more. Any face: the head is not a ball and the hair has locks ([modeling.md](../skills/spritekiln/SKILL.md), "Heads, faces and hair") | | `pose --focus head`: no bump under 2 px on the face; the head and hair read as this character |
| animation `fluid` | | walk and run 8 frames, idle 6–8, tweens on actions, overlap and follow-through | |
| animation `snappy` | | walk and run 4–6 frames, idle 2–4, held keys, few or no tweens | |
| colors, references, notes | the palette, ramps and accents follow them | timing and feel follow them | the asset reads as the same game as the references and the approved assets |

© LucasJRamos · MIT · LucasJRamos/spritekiln

Similar subagents

All subagents for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set10

The whole set →
spritekiln spritekiln is a Claude Code rule for building SpriteKiln sprites from YAML specs. It activates on files matching specs/**/*.yaml. CX Codex +1 ★ 177repo stars animator The animator subagent for Claude Code builds and polishes SpriteKiln animations. It handles per-frame timing, anticipation, and overlap checks across eight directional views. CX Codex ★ 177repo stars pixel-art-director pixel-art-director is a Claude Code subagent that reviews SpriteKiln renders and animations. It evaluates silhouettes, contrast, and faces before asset sign-off without editing project files. CX Codex ★ 177repo stars spritekiln-splash-to-model spritekiln-splash-to-model is a Claude Code skill that turns a character image into a SpriteKiln spec. It activates for requests to create a model, sprite, or animation from concept art. CX Codex +1 ★ 177repo stars pxforge-splash-to-model pxforge-splash-to-model is a Claude Code skill that turns splash art into a SpriteKiln YAML model. It runs when you supply a character image to generate a model, sprite or animations. CX Codex +1 ★ 177repo stars spritekiln-animation spritekiln-animation is a Claude Code skill for building and tuning animations from a SpriteKiln spec. It covers small pixel-art characters in eight directions and marks gameplay events. CX Codex +1 ★ 177repo stars pxforge-animation pxforge-animation is a Claude Code skill that builds and tunes 8-directional pixel art animations in SpriteKiln specs. It handles periodic cycles, attack keys, and gameplay sockets. CX Codex +1 ★ 177repo stars spritekiln spritekiln is a Claude Code skill for making and editing animated pixel-art characters, monsters, and props in eight directions. Before the project's first asset, it asks about the art style. CX Codex +1 ★ 177repo stars

Project sponsors

Companies that keep this analytics open