sumi-vector — скилл для Claude Code: что делает и как установить
Скилл sumi-vector для Claude Code собирает анимационные фильмы на JavaScript через p5.brush. Рендерит силуэты тушью и акварельные фоны на 24 кадрах в секунду без генерации картинок.
MIT ★ 110 обновлён 2026-11-07
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a claude-codeЧто делает sumi-vector
Скилл генерирует сцены в scenes/film.js, где каждый кадр рисуется кодом с нуля по заданной позе. Персонажи выводятся тёмными силуэтами туши с плоской заливкой, а фоны оформляются как акварельные пейзажи без параллакса. Кадры разбиваются по отдельным слоям для мира, персонажей и световых эффектов с режимом blend: "screen".
Захват кадров выполняет скрипт tools/vector-capture.mjs, а сборку видео и проверку движений берут на себя sumi-render.mjs и motion-check.mjs. Просмотреть отдельный слой без захвата можно в браузере через engine/film.html. Подход лучше всего подходит для ткани, волос и погодных эффектов, но слабее справляется со сложной мимикой лиц.
Без WebGL анимация не запустится. Для рендера требуются Node 22+, браузер Chromium, Chrome или Edge с поддержкой WebGL и утилита FFmpeg. Библиотеки p5.js и p5.brush уже лежат в каталоге engine/vendor.
Какие задачи решает
- создать покадровую 2D-анимацию на JavaScript без затрат на генерацию изображений
- отрендерить силуэтных персонажей и акварельные фоны через p5.brush
- проверить сцену и экспортировать видео через FFmpeg на частоте 24 кадра в секунду
Примеры запросов агенту
- Напиши сцену scenes/film.js для персонажа в профиль на фоне заката
- Запусти захват тестового кадра 160 слоя actors через vector-capture.mjs
- Собери итоговый ролик через sumi-render.mjs со звуковой дорожкой sound/mix.wav
Как установить sumi-vector
1Через Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a claude-code2Вручную: положить файлы
~/.claude/skills/sumi-vector/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sumi-vector/
1Через Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a codex2Вручную: положить файлы
.agents/skills/sumi-vector/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a cursor2Вручную: положить файлы
.cursor/skills/sumi-vector/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install beyondtahir/beyondsumi skills/sumi-vector2Вручную: положить файлы
.github/skills/sumi-vector/SKILL.md1Через Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-vector -a gemini-cli2Командой платформы
gemini skills install https://github.com/beyondtahir/beyondsumi --path skills/sumi-vectorВручную: положить файлы
.devin/skills/sumi-vector/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sumi-vector
Как установить sumi-vector в Claude Code?
Выполните команду npx skills add beyondtahir/beyondsumi --skill sumi-vector -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/sumi-vector/SKILL.md.
Что делает sumi-vector?
Генерирует код анимационных сцен на p5.brush, рисует силуэты и акварельные фоны, после чего собирает видеопоток без вызовов нейросетей для картинок.
Что нужно для работы sumi-vector?
Требуются Node 22+, Chromium, Chrome или Edge с активным WebGL и установленный в системе FFmpeg. Библиотеки p5.js и p5.brush уже включены в репозиторий.
Исходный текст
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