Skip to main content
skill CX Codex

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

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.

MIT ★ 110 updated 2026-11-07

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

What sumi-vector does

The skill writes animated scenes into scenes/film.js, drawing each frame fresh from poses at 24 frames per second. It separates actors, worlds, and lighting into distinct layers, rendering backgrounds once with boil: 0 and lighting passes with screen blending.

Frames are captured through tools/vector-capture.mjs, while final assembly and motion diagnostics use sumi-render.mjs and motion-check.mjs. You can also preview individual layers directly in a browser via engine/film.html. The approach handles cloth, hair, and weather well, but it relies on profile faces because fine facial detail is limited.

Rendering fails completely without WebGL. Setup requires Node 22+, FFmpeg, and Chrome, Edge, or Chromium with WebGL support. Both drawing dependencies, p5.js and p5.brush, come pre-packaged in engine/vendor.

What it helps with

  • animate 2D character silhouettes in JavaScript at 24 fps without image model costs
  • render multi-layer scenes with watercolor backgrounds using p5.brush
  • export and inspect animated footage using FFmpeg and local capture scripts

Example prompts for the agent

  • Write a new scene in scenes/film.js following the director shot list
  • Capture test frame 160 of the actors layer using vector-capture.mjs
  • Render the final animation with shots.json and audio track sound/mix.wav

How to install sumi-vector

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about sumi-vector

How to install sumi-vector in Claude Code?

Run npx skills add beyondtahir/beyondsumi --skill sumi-vector -a claude-code. The skill file will be placed in ~/.claude/skills/sumi-vector/SKILL.md.

What does sumi-vector do?

It animates vector films in JavaScript with p5.brush, drawing ink silhouettes and painted skies on separate layers without image generators.

What does sumi-vector require?

It requires Node 22+, FFmpeg, and Chrome, Edge, or Chromium with WebGL enabled. The p5.js and p5.brush libraries are already bundled in engine/vendor.

Source text

SKILL.md · MIT
---
name: sumi-vector
description: "Make Sumi Vector films: ink silhouettes and flat colour on painted skies, with every drawing painted in JavaScript using p5.brush. Needs no images and no image tool. Use for Sumi Vector, or when the user has no image tool or wants no image cost."
---

# Sumi Vector: drawing with code

The third Beyondsumi style. You are the Artist and Animator, and your brush is JavaScript. Each drawing is painted fresh from a pose, and it costs nothing in images.

The studio is the same as every other style. The [Writer](../sumi-writer/SKILL.md) and [Director](../sumi-director/SKILL.md) work first, then [Sound](../sumi-sound/SKILL.md) for any voice takes, then you, then Sound again for music and effects, the [Checker](../sumi-checker/SKILL.md), the audience panel and quality assurance. Set `"style": "vector"` and `"art_route": "vector"` in `shots.json`.

## The rule

Every drawing is **painted fresh from a pose** written for that drawing. Never bend a finished picture. Drawings are free here, so animate characters at 24 a second.

## How to make it

1. **Read** [how to write a scene](references/scene-guide.md).
2. **Study** [The Lantern](examples/lantern/scene.js), a full 20-second film with a story, [its script](examples/lantern/script.md) and [its plan](examples/lantern/shots.json).
3. **Write the scene** as `scenes/film.js`, following the Director's shots. Keep the world, the characters and the effects on separate layers.
4. **Look at the hardest drawing first,** at full size over its background, before capturing the rest:

   ```bash
   node tools/vector-capture.mjs scenes/film.js frames/test --layer actors --only 160
   ```

5. **Capture every drawing:**

   ```bash
   node tools/vector-capture.mjs scenes/film.js frames --all
   ```

6. **Render and check** with the same tools as every other style:

   ```bash
   node ../sumi/tools/sumi-render.mjs shots.json --audio sound/mix.wav
   node ../sumi/tools/motion-check.mjs shots.json --video out/film.mp4
   node ../sumi/tools/drawing-check.mjs shots.json
   ```

To preview a layer without capturing it, open `engine/film.html?scene=PATH/film.js&layer=actors` in a browser.

## The look

- **Figures:** dark ink silhouettes with big clear shapes, like a wide hanging sleeve, and one warm rim of light on the side facing the light. Flat, opaque colour and no soft gradients. Use one vivid accent, such as a red sash.
- **Outlines:** round every outline before filling it, so nothing looks cut from straight lines. Hair is many strands of different lengths, never one slab.
- **Worlds:** painted watercolour skies and hills, softer than the characters. Paint them once with `boil: 0`.
- **Place:** one or two strong, real details that say where we are, such as a pine or a torii gate.
- **Light:** a separate `light` layer rendered with `"blend": "screen"`. A glow from behind the figure goes in its own layer under the figure, or it washes the silhouette out.
- **No parallax:** every layer has the same depth.
- **Scene changes:** clean cuts and dissolves.

## What it can and cannot do

| Good at | Weaker at |
|---|---|
| Painted skies, weather, light, cloth, hair and grass | Rich faces and detail, where images are better |
| Any amount of movement at no cost | Complex acting from difficult angles |
| Long films, since cost does not grow | |

Direct around the limits: silhouettes against bright sky, profile faces, big clear shapes, hands in clear space. Let hands and objects carry the close-up. Say honestly that faces are simpler than in Sumi Dark and Sumi Light.

Beautiful movement is not a film. Even at 15 seconds it needs a question and a clear answer. Audience panels failed an early Lantern as a "flat puppet with no story", which is why it was remade.

## Reject your own work when

- A figure looks like a doll, a tube, a stick or a Flash puppet, or its hair looks like spikes or a solid block.
- A sleeve or arm crosses the face, or a face touches the object it looks at.
- A bent arm's elbow goes up across the body. Check the `limb` bend direction.
- A hand is not joined to its arm, or a sleeve looks like a wing.
- Something is see-through that should be solid, or a cut-out looks pasted on.
- Strokes or stray marks cross the sky or the face.

## What it needs

Node 22+, Chrome, Edge or Chromium with WebGL, and FFmpeg. The two drawing libraries, p5.js (LGPL-2.1) and p5.brush (MIT), are in `engine/vendor` with their licences, so nothing needs installing. Keep those files as they are. If WebGL does not run, tell the user, because this style cannot work without it.

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