Skip to main content
skill CX Codex

sumi — Claude Code skill: what it does, how to install

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.

MIT ★ 110 updated 2026-11-07

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

What sumi does

sumi sets up a sequential production studio where the agent acts as writer, director, artist, animator, sound engineer, and checker. Every department commits its output to disk: text goes to script.md, scene counts and styles to shots.json, frames to frames/. When dialogue is present, voice tracks are recorded before drawing starts so mouths match recordings.

Projects run in three visual formats: brush-based Sumi Dark with parallax, coloured pencil Sumi Light, and code-driven Sumi Vector. Sumi Vector renders all motion in JavaScript without image generation costs at up to 24 drawings a second. Sumi Dark and Sumi Light depend on image tools, so Claude Code needs an external image integration because the model cannot generate pictures natively.

What it helps with

  • orchestrate a frame-by-frame animation pipeline
  • plan scene shotlists and image generation budgets
  • sync drawn character poses to prerecorded voice tracks
  • render vector animated sequences using JavaScript code

Example prompts for the agent

  • Start a new animation project with node tools/sumi-plan.mjs new my_film --style dark --title "Night Hunt"
  • Estimate image generation expenses using node tools/sumi-plan.mjs budget shots.json
  • Run the checker role on the rendered movie

How to install sumi

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about sumi

How to install sumi in Claude Code?

Run npx skills add beyondtahir/beyondsumi --skill sumi -a claude-code. Alternatively, copy the instruction file to ~/.claude/skills/sumi/SKILL.md.

What does the sumi skill do?

It enforces a traditional animation pipeline with strict division between writing, directing, drawing, and sound. The workflow bans morphing, image warping, and still-frame zoom effects.

What is required to run sumi?

The workflow requires node and python3 for execution scripts such as sumi-plan.mjs. For Sumi Dark and Sumi Light under Claude Code, you need an external image generation service.

Source text

SKILL.md · MIT
---
name: sumi
description: "Make Japanese Sumi animated films and videos frame by frame, in Sumi Dark, Sumi Light or Sumi Vector. Runs a small studio: writer, director, artist, animator, sound and checker. Use for Beyondsumi, Sumi animation, animated stories, or ink, brush and pencil-sketch animation."
---

# Beyondsumi

Version 2.0.0. A small animation studio that works like an old-school hand-drawn team. One assistant plays each role in turn. Each role saves its work as a file, so any assistant can continue from those files, even in a new chat.

## The one rule

**Every movement is drawn.** Motion comes from separate drawings shown one after another. Never warp, morph, rig or bend a picture to fake movement, and never treat a slow zoom on a still image as animation. A character may hold still only when the Director gives a story reason.

## The three styles

All three are Japanese style, and all characters look Japanese anime. This is the drawing style; the story can be set anywhere.

| Style | Look | Stories | Depth | Scene changes |
|---|---|---|---|---|
| **Sumi Dark** | Black and white brush, always with vivid red and one more vibrant colour | Horror, mystery, adventure | Parallax from separate images | Drawn ink, or a hard cut |
| **Sumi Light** | Clear, dark colour pencil sketch | Children's stories, love stories | No parallax; the background is animated with drawn frames | Drawn in sketch, or a cut |
| **Sumi Vector** | Clean lines and flat colour on painted skies, drawn in code with no images | Any story, and anyone without an image tool | No parallax | Clean cut or dissolve |

## Guide the user, always

Treat every user as a complete beginner unless they say otherwise. Anyone new gets the [first-time helper](references/first-run-flow.md). Every film, every time, follows the [film guide](references/film-guide.md): say where you are, what this step does, what it costs and exactly what they can reply.

## The studio, in order

Load only the role you are working as, along with the film guide.

| Step | Role | Skill | Saves | The user approves |
|---|---|---|---|---|
| 1 | Writer | [sumi-writer](../sumi-writer/SKILL.md) | `script.md` | The words |
| 2 | Director | [sumi-director](../sumi-director/SKILL.md) | `shots.json` | The scenes, style and drawing count |
| 3 | Artist | [sumi-artist](../sumi-artist/SKILL.md) | `art/` and `sheets/` | The look and characters |
| 4 | Animator | [sumi-animator](../sumi-animator/SKILL.md) | `frames/` and `out/` | Key poses, then the moving shot |
| 5 | Sound | [sumi-sound](../sumi-sound/SKILL.md) | `sound/` | The mix |
| 6 | Checker | [sumi-checker](../sumi-checker/SKILL.md) | `out/motion-check.json` | The finished film |

**When a film has speech, the voice comes before the drawings.** Sound makes and approves the voice takes straight after the Director, so the drawings and mouths follow the real recording and nothing is paid for twice. Step 5 then adds music and effects.

Work moves forward only after approval, and goes back when a role finds a problem. If the Animator finds a shot cannot work in the planned drawings, it goes back to the Director. It is never quietly faked. Prove the hardest shot first, before making the whole film.

## Two ways to draw

- **Images:** the Artist and Animator use an image tool, with drawings on HD sheets.
- **Vector:** [Sumi Vector](../sumi-vector/SKILL.md) is its own style. The assistant paints every drawing with JavaScript, at no image cost and up to 24 drawings a second. Sumi Dark and Sumi Light need images.

ChatGPT and Codex use the best image model they have. Claude has no image model, so it asks the user for access to a third-party image tool, or animates in code with Sumi Vector. See [image routes](../sumi-artist/references/image-routes.md).

The Director records the choice as `"art_route"` in `shots.json`.

## Where to start

Run commands in the film's folder, not the skill's. The guides write `../sumi/tools/NAME.mjs` to keep them short. Use the full paths listed in the film's `STUDIO.md` instead. For the first command, `sumi-plan.mjs new`, use the `tools` folder beside this file.

- **First use:** follow the [first-time helper](references/first-run-flow.md). Check with `python3 scripts/first_run.py`: if `welcome_needed` is true, this person is new, so show the welcome and six steps in the chat before anything else, even if they asked straight for a film.
- **New film:** `node tools/sumi-plan.mjs new FOLDER --style dark --title "Title"`, adding `--shape vertical` for a vertical film, then start with the Writer and follow the [film guide](references/film-guide.md). If the user already has a finished script they want kept word for word, the Writer only checks it.
- **Continuing a film:** read the project's `STUDIO.md`, then continue from the first step without an approval.
- **A change to a finished film:** go to the role that owns it, and redo only what it affects.
- **Delivery:** follow [delivery](references/delivery-dashboard.md).

## Spending and honesty

- Before any paid image or voice work, show what will be made and how many. Use `node tools/sumi-plan.mjs budget shots.json`. A connected key is not permission to spend.
- If a tool cannot run, stop and tell the user why in plain words. Never build your own drawing or render tool, skip the checks or change the look to get round it.
- Never write a claim you did not check. Do not say a film passed unless the Checker ran, and do not say it looks or sounds good unless a person watched and listened.
- No AI labels, watermarks or technical text in the exported film. Follow the rules of the platform where the user publishes it.
- Keep keys and private recordings out of project files and out of this package. Personal choices live in [external memory](references/memory.md).

## The full process

Follow [how a film gets made](references/production-flow.md), including the choices for each assistant, sound routes, the audience panel and quality assurance.

© beyondtahir · MIT · beyondtahir/beyondsumi

Similar skills

All skills for Design →
rive-interactive freshtechbro rive-interactive — a skill for Claude Code, Codex, Cursor and other platforms that teaches agents the Rive animation stack: state machines, ViewModel data binding, and custom event handling. CX Codex +1 2,900installs lottie-animation-delivery calesthio The lottie-animation-delivery skill for Claude Code manages the integration of Lottie and dotLottie animations into apps. It validates compatibility and render-target requirements. CX Codex +1 137installs sakuga-vfx finktheartist The sakuga-vfx Claude Code skill adds anime-style motion and drawn effects to UI controls. It activates when adding or changing sakuga-* components, or creating a new control in the same style. CX Codex +1 ★ 419repo stars generating-cartoon-videos SupercmoHQ generating-cartoon-videos produces cartoon and animated product videos with a consistent art style and recurring characters. Helpful when creating animated explainer spots or mascot-driven product ads. CX Codex +1 ★ 331repo stars anime-reaction-gif LIghtJUNction anime-reaction-gif — a plugin for Claude Code and Codex that builds looping reaction GIFs and MP4s from generated pose sheets. It drives image_gen for key poses, then hands the frames to FFmpeg for timing and export. CX Codex ★ 1,596repo stars makepad-2.0-vector ZhangHanDong makepad-2.0-vector teaches your coding assistant how to write vector shapes and animations for Makepad 2.0. Generates inline SVG paths, gradients, and UI icons. CX Codex +1 ★ 754repo stars

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

Project sponsors

Companies that keep this analytics open