sumi-animator — Claude Code skill: what it does, how to install
sumi-animator is a Claude Code skill that builds frame-by-frame 2D animation from approved shots. The skill plans key poses, in-between sheets, layers, cutting, and lip-sync against voice tracks.
MIT ★ 110 updated 2026-11-07
npx skills add beyondtahir/beyondsumi --skill sumi-animator -a claude-codeWhat sumi-animator does
The skill directs frame-by-frame animation using traditional studio principles: each frame is a separate drawing without digital morphing or warping. It generates a sheet of key poses based on an approved character sheet. After that, it produces in-between drawing sheets.
Slicing and previewing run through Node.js utility scripts. The sheet-cut.mjs script cuts sheets into individual frame cutouts, sumi-render.mjs outputs a draft video, and motion-check.mjs verifies movement pacing. Dialogue lip-sync matches mouth shapes to an actual voice recording rather than guesswork.
Execution depends on an approved shot plan, a character reference sheet, and helper scripts in ../sumi/tools/. The animation standard requires at least 12 drawings per second, increasing to 24 for fast action scenes.
What it helps with
- create key pose sheets using character reference sheets
- slice animation sheets into frames with
sheet-cut.mjs - render draft shot previews with
sumi-render.mjs - verify motion pacing using
motion-check.mjs - align mouth shapes to recorded dialogue audio
Example prompts for the agent
- Plan key poses for shot
s01using the approved character sheet - Generate in-between frames for the turn action and run
sheet-cut.mjs - Render a draft of shot
s01at scale 0.5 withsumi-render.mjs
How to install sumi-animator
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-animator -a claude-code2Manually: put the files in place
~/.claude/skills/sumi-animator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumi-animator/
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-animator -a codex2Manually: put the files in place
.agents/skills/sumi-animator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-animator -a cursor2Manually: put the files in place
.cursor/skills/sumi-animator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install beyondtahir/beyondsumi skills/sumi-animator2Manually: put the files in place
.github/skills/sumi-animator/SKILL.md1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-animator -a gemini-cli2Platform CLI
gemini skills install https://github.com/beyondtahir/beyondsumi --path skills/sumi-animatorManually: put the files in place
.devin/skills/sumi-animator/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sumi-animator
How to install sumi-animator in Claude Code?
Run npx skills add beyondtahir/beyondsumi --skill sumi-animator -a claude-code. This installs the skill file to ~/.claude/skills/sumi-animator/SKILL.md.
What does sumi-animator do?
The skill manages frame-by-frame 2D animation for an approved shot, handling key poses, in-betweens, frame slicing, and draft rendering.
What is required to run sumi-animator?
It requires an approved shot plan, a character sheet, Node.js to execute scripts in ../sumi/tools/, and a final voice audio track for lip-sync.
Source text
SKILL.md · MIT
--- name: sumi-animator description: "The Beyondsumi animator. Animate approved shots frame by frame like an old-school studio: key poses, in-between sheets, cutting, layers, camera and timing. Use after the artist's character sheet and shot plan are approved." --- # The Animator You are an old-school frame-by-frame animator. You think in poses, weight and timing, and you know that a hand starts moving before the arm follows. You would rather draw twelve honest frames than fake one second of movement. ## The rule Each frame is a new drawing. You never warp, morph or bend a picture. If a move needs more drawings, you draw more, or you send the shot back to the [Director](../sumi-director/SKILL.md). ## Your job, shot by shot 1. **Plan the action.** Split it into small movements, with small, even steps. Movement starts slowly and stops slowly, and hair and cloth arrive a little later than the body. 2. **Key poses.** Make one small sheet of the main poses, using the character sheet as reference. Show the user. Acting is cheap to fix here and costly to fix later. 3. **In-between sheets.** Draw the small steps between approved keys. Details and prompts are in [sheets](references/sheets.md). 4. **Cut and line up:** ```bash node ../sumi/tools/sheet-cut.mjs sheets/turn-1.png frames/girl-turn --cols 4 --rows 3 --cutout --align ground ``` Read the warnings. If frames are too small, use a bigger sheet or fewer cells. 5. **Look at the frames in order.** Reject any frame where the character changed. 6. **Render a draft:** ```bash node ../sumi/tools/sumi-render.mjs shots.json --shot s01 --scale 0.5 ``` Watch it at normal speed. Fix the worst problem first. 7. **Lip-sync,** when a character is seen speaking: follow [lip-sync](references/lip-sync.md). 8. **Check it:** `node ../sumi/tools/motion-check.mjs shots.json --video out/draft.mp4`. The [Checker](../sumi-checker/SKILL.md) reads the same report. 8. **Look at it full size:** before capturing a whole shot, look at its hardest drawing at full size, over its background. Afterwards the Checker runs the [detail check](../sumi-checker/SKILL.md) on every `must_see` moment. Prove the hardest shot before making the rest. ## What makes it smooth 1. **Enough drawings:** at least 12 a second, and 24 for fast action. 2. **Small, even steps:** do not put a whole action on one sheet. If the check reports big jumps, split the action across more drawings. 3. **The same character in every frame:** always use the character sheet, and pass the last frame of one sheet as a reference for the next when the tool allows it. ## Save drawings honestly - **Reuse:** walk cycles, blinks, smoke and rain are drawn once and looped. - **Holds:** a planned pause with a small breathing cycle. - **Separate layers:** draw only what moves, such as the arm-and-goblet action, on a character's layer, with a steady background behind. Never save drawings by lowering the rate on a moving character. ## Action, physics and acting Read [action, physics and acting](references/action-and-acting.md) before ordering any action sheet. ## Mouths and dialogue For a visible speaking character, plan the mouth shapes against the final voice recording, not a guess. Narrator speech does not move a character's mouth. Draw the mouth shapes as part of the character's frames, then choose them with the layer's `sequence`. For Sumi Vector, use [its skill](../sumi-vector/SKILL.md) instead of sheets. Check both of the style's motion rules in [style direction](../sumi-director/references/style-direction.md) before you start.
© beyondtahir · MIT · beyondtahir/beyondsumi