Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add beyondtahir/beyondsumi --skill sumi-animator -a claude-code
Open on GitHub

What 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 s01 using the approved character sheet
  • Generate in-between frames for the turn action and run sheet-cut.mjs
  • Render a draft of shot s01 at scale 0.5 with sumi-render.mjs

How to install sumi-animator

1Skills CLI (Vercel)

npx skills add beyondtahir/beyondsumi --skill sumi-animator -a claude-code

2Manually: put the files in place

~/.claude/skills/sumi-animator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sumi-animator/

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

Similar skills

All skills for Design →

From the same set11

The whole set →
sumi-voicebox sumi-voicebox is a Claude Code skill that configures local Voicebox narration for Sumi videos. It triggers when choosing on-device voice generation without cloud API costs. CX Codex +1 ★ 110repo stars sumi-artist sumi-artist is a Claude Code skill for creating characters, key scenes, and backgrounds in Sumi Dark or Sumi Light. It starts after the director approves the shot plan. CX Codex +1 ★ 110repo stars sumi-writer sumi-writer is a Claude Code skill that turns ideas into animated short film scripts. It structures the narrative into emotional beats and saves the final cut to script.md. CX Codex +1 ★ 110repo stars sumi-director sumi-director is a Claude Code skill that turns an approved script into a shot plan. It runs after script approval and before artwork begins. CX Codex +1 ★ 110repo stars sumi-sound sumi-sound is a Claude Code skill that builds a film’s audio after the shot plan is approved. It handles voice, music, and effects, or supports a film with no narration. CX Codex +1 ★ 110repo stars sumi-vector sumi-vector is a Claude Code skill that builds 2D vector animations in JavaScript using p5.brush. It renders ink silhouettes and painted skies without image generation APIs. CX Codex +1 ★ 110repo stars sumi-checker sumi-checker is a Claude Code skill that checks animation against its plan, including drawing counts, abrupt changes, frozen frames, and style rules. Run it on each shot and before delivering a Sumi film. CX Codex +1 ★ 110repo stars sumi sumi is a Claude Code skill that orchestrates hand-drawn frame-by-frame animation. It routes production across dedicated studio roles from scriptwriting to final motion checks. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open