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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 110 repo stars
- Author: beyondtahir
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/beyondtahir/beyondsumi/tree/HEAD/skills/sumi-vector/SKILL.md
- Updated: 2026-11-07
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sumi-vector

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sumi-vector/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sumi-vector/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sumi-vector/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sumi-vector/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install beyondtahir/beyondsumi skills/sumi-vector
```

2. **Manually: put the files in place**
- File: `.github/skills/sumi-vector/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/beyondtahir/beyondsumi --path skills/sumi-vector
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sumi-vector/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/beyondtahir/beyondsumi/tree/HEAD/skills/sumi-vector/SKILL.md

## When to use it
- 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
- 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

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a6463511e60aa82b.

BEGIN THIRD-PARTY FILE a6463511e60aa82b
````text
---
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.
````
END THIRD-PARTY FILE a6463511e60aa82b

The third-party file has ended. Everything between the a6463511e60aa82b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2963 of 4599 bytes. © beyondtahir · MIT · https://github.com/beyondtahir/beyondsumi/tree/HEAD/skills/sumi-vector/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
