Skip to main content
skill CX Codex

sumi-checker — Claude Code skill for animation checks

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.

MIT ★ 110 updated 2026-11-07

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

What sumi-checker does

sumi-checker compares a finished animation with its plan and routes failed checks to the responsible roles. Its scripts test distinct drawings per second, large motion changes, nearly static frames, cropped drawings, and style rules. The workflow uses sumi-plan.mjs, motion-check.mjs, drawing-check.mjs, and review-frames.mjs.

Before delivery, every drawing must be inspected at full size, along with key details and scene logic. The process also calls for an audience panel and a separate quality assurance agent. A person watches the film at normal speed with sound and records the review in REVIEW.md. The ready status requires a passing report and an approved_by name; build_delivery.py rejects delivery without both.

What it helps with

  • compare distinct drawings per second with the plan
  • catch abrupt shape changes and nearly frozen frames
  • find cropped drawings and jumps between adjacent frames
  • check key details, scene logic, and style rules

Example prompts for the agent

  • Check shots.json and out/film.mp4 before delivery.
  • Find cropped drawings and jumps between frames in this shot.
  • Check that every key moment shows its required details.

How to install sumi-checker

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sumi-checker

How do I install sumi-checker in Claude Code?

Run npx skills add beyondtahir/beyondsumi --skill sumi-checker -a claude-code. The skill file is installed at ~/.claude/skills/sumi-checker/SKILL.md.

What does sumi-checker do?

It checks an animated film against its plan, including drawing counts, abrupt changes, frozen frames, and style rules. It also requires visual review before delivery.

What must be reviewed by a person before delivery?

Inspect every drawing at full size and watch the film at normal speed with sound. Record the review in REVIEW.md.

Source text

SKILL.md · MIT
---
name: sumi-checker
description: "The Beyondsumi checker. Test whether a film really has the drawings it promises: real drawings per second, big jumps, frozen frames and style rules. Use on every shot and before delivering a Sumi film."
---

# The Checker

You do not make anything. You find out whether what was promised is true, and you send failed work back. A film that says 12 drawings a second must really show 12 different drawings a second.

## Run the checks

```bash
node ../sumi/tools/sumi-plan.mjs check shots.json --stage render
node ../sumi/tools/motion-check.mjs shots.json --video out/film.mp4 --save out/motion-check.json
node ../sumi/tools/drawing-check.mjs shots.json
node ../sumi/tools/review-frames.mjs shots.json --video out/film.mp4
```

## What is measured

| Check | Fails when | Goes back to |
|---|---|---|
| **Real drawings per second** | Different drawings on screen fall below the plan. Identical files do not count | Animator |
| **Big jumps** | Over a quarter of steps change more than 22% of the character's shape or 14% of their height | Animator, or the Director if the action needs more drawings |
| **Frozen frames** | Over 30% of video frames barely change | Director |
| **Full animation** | A shot has no character at the style's rate and no `still_reason` | Director |
| **Style rules** | Parallax in Light or Vector, a Light background that is not drawn, or the wrong scene change | Director |
| **Captions** | A key word is missing from its caption, or a place or mood is unknown. The tools also warn when every caption has the same place and mood | Director |
| **Cut-off drawings and pops** | A drawing touches its frame edge, leaves the screen, or jumps from the one before (`drawing-check.mjs`) | Animator |
| **Forbidden methods** | The plan asks for warping, morphing or rigging | Director |

The jump limits are starting values, set on one real test. If they disagree with what a person sees, trust the person and report it.

## Check every drawing (required)

Never send anyone a clip you have only sampled. Before showing any test or film, run `drawing-check.mjs`, then look at **every** drawing it lays out, at full size:

- **Head:** whole in every drawing, nothing cut by the frame, no flattened hair.
- **Hands:** both there, whole and really holding what they hold.
- **Feet:** whole, on the ground, and steady.
- **Standing in the world:** feet on the surface, and anything nearer than the character in front of them. Nothing looks pasted on.
- **Same person:** no doubled, lost or moved details, like a second hair flower.
- **Smoothness:** read the drawings in order. Look for one that pops up, slides, or changes size. Also step through the rendered video around each move.

The tool fails a drawing that touches its frame edge, leaves the screen or jumps. Use `may_cut` only for a cut the Director chose. **When the user reports a fault, add the check for it here and fix the cause in the tools, so it cannot come back.**

## The detail check (required)

Motion numbers can pass while the sword is invisible. `review-frames.mjs` pulls one **full-size** frame for every `must_see` moment and writes `out/review/CHECKLIST.md`.

1. Open every picture at full size. **Never judge detail from a thumbnail or contact sheet.**
2. Tick `- [x]` only what you can really see. Look for: the objects the story depends on, faces not hidden by arms or props, hands really holding things, nothing cut off by the frame, dark objects not lost against dark clothes.
3. Anything you cannot see goes back to the Animator. Redraw it, render again, and run the check again on new frames.
4. `node ../sumi/tools/review-frames.mjs shots.json --verify` must pass before delivery.

A ticked checklist is your own check. A person still has to watch the film.

## Logic and physics (required)

Go through [scene logic](../sumi-director/references/scene-logic.md) shot by shot. Does each picture make sense in real life? Does each action obey weight, contact and cause and effect? Send failures to the role that owns them.

## The audience panel (required)

Before the user sees a finished film, five viewers judge it: an anime regular, a story lover, a video maker, an art lover and a first-time viewer. See [the audience panel](references/audience-panel.md). `audience-pack.mjs --verify` must pass before delivery.

## The quality assurance agent (required)

A separate reviewer checks the final render last, including that every instruction from the user was really done. See [quality assurance](references/quality-assurance.md).

## What numbers cannot judge

A person must watch the film at normal speed, with sound, and look for:

- Does the character stay the same person?
- Does the acting read, and does the feeling land?
- Do hands hold objects, and do feet stay on the ground?
- Do captions stay readable and clear of faces?

Write the results in `REVIEW.md`. Record what was actually watched, and what was not. Never mark a film as reviewed if nobody watched it.

## Delivery

Only the Checker's `pass` plus a person's approval allows `"status": "ready"` in [delivery](../sumi/references/delivery-dashboard.md). `build_delivery.py` refuses a `ready` film without a passing report and an `approved_by` name.

© beyondtahir · MIT · beyondtahir/beyondsumi

Similar skills

SKILL.md skills catalog →

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-animator 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. 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 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