living-ascii — скилл для Claude Code: анимация изображения
Скилл living-ascii для Claude Code превращает неподвижное изображение в зацикленное ASCII-видео. Запускается по просьбе оживить картинку или заставить колыхаться траву, волосы и мазки.
MIT ★ 68 обновлён 2026-11-04
npx skills add yusen-dev/living-ascii --skill living-ascii -a claude-codeЧто делает living-ascii
Скилл превращает одно изображение в зацикленное MP4: создаёт движущиеся пряди и слой ASCII-символов, ориентированный по их направлению. Лучше подходят изображения с множеством тонких штрихов: трава, шерсть, волосы, пшеница или мазки кисти. Здания, лица и текст могут размазаться.
Для работы нужно выполнить npm install, затем запустить сервер командой npm start и открыть предпросмотр в браузере. Параметры задаются в URL: можно менять направление ветра, освещение, плотность прядей и размер кадра. Экспорт сохраняется в out/NAME-ascii.mp4; при запросе можно также получить версию без ASCII-слоя. После экспорта скилл проверяет стык цикла, заметность движения и цвет.
Какие задачи решает
- превратить неподвижную картинку в ASCII-анимацию
- сделать бесшовный видеолуп из изображения
- анимировать колыхание травы, волос или мазков кисти
Примеры запросов агенту
- Преврати
input/meadow.pngв зацикленное ASCII-видео. - Сделай так, чтобы волосы на
input/portrait.pngслегка колыхались. - Экспортируй изображение
input/wheat.pngв MP4 с ASCII-слоем и без него.
Как установить living-ascii
1Через Skills CLI (Vercel)
npx skills add yusen-dev/living-ascii --skill living-ascii -a claude-code2Вручную: положить файлы
~/.claude/skills/living-ascii/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/living-ascii/
1Через Skills CLI (Vercel)
npx skills add yusen-dev/living-ascii --skill living-ascii -a codex2Вручную: положить файлы
.agents/skills/living-ascii/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add yusen-dev/living-ascii --skill living-ascii -a cursor2Вручную: положить файлы
.cursor/skills/living-ascii/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install yusen-dev/living-ascii living-ascii2Вручную: положить файлы
.github/skills/living-ascii/SKILL.md1Через Skills CLI (Vercel)
npx skills add yusen-dev/living-ascii --skill living-ascii -a gemini-cli2Командой платформы
gemini skills install https://github.com/yusen-dev/living-asciiВручную: положить файлы
.devin/skills/living-ascii/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о living-ascii
Как установить living-ascii в Claude Code?
Выполни npx skills add yusen-dev/living-ascii --skill living-ascii -a claude-code. Файл скилла находится по пути ~/.claude/skills/living-ascii/SKILL.md.
Что делает living-ascii?
Он превращает одно изображение в зацикленное MP4 с движущимися прядями и ASCII-слоем. Можно также экспортировать видео только с прядями.
Какие изображения подходят для living-ascii?
Лучше работают изображения с тонкими штрихами, направленными в одну сторону: например, трава, волосы или мазки. Здания, лица и текст могут размазаться.
Исходный текст
SKILL.md · MIT
--- name: living-ascii description: Bring a still image to life as a seamless looping ASCII video. The image becomes ~160k swaying strands that move like a school of fish, with an ASCII layer whose characters turn with the strands beneath them; exports an MP4. Use when someone asks to animate a still image, make an image "move" or "breathe", turn a picture into an ASCII animation or ASCII video loop, or make grass, fur, hair, wheat or brush strokes sway. --- # living-ascii Turns one image into a seamless loop: strands that sway like a school of fish, plus an ASCII layer whose stroke glyphs follow each strand's heading. Output is an MP4 (ASCII, and optionally the strands without ASCII). ## Workflow 1. **Install once.** In the repo folder: `npm install`. 2. **Place the image** in `input/`. Read it first and say whether it suits the effect: best are images of many fine strokes with a clear direction (grass, fur, hair, wheat, reeds, painterly brushwork, wind-swept water). Hard-edged subjects (buildings, faces, text) smear; say so before spending a render. 3. **Start the server** with `npm start` (port 5177; set `PORT` to change it). Run it in the background. 4. **Preview stills** in a browser tab you control (never one the user is watching): `http://localhost:5177/?img=input/NAME&t=0.25`, plus `&mode=flow` for the strands alone. Check: - **Wind direction** (`wind`): default `auto` follows the texture. If strands run against the obvious flow, set degrees (0 = right, 90 = up). - **Light** (`light`): set to where the light in the image comes from (130 = upper left, 45 = upper right, 270 = below). - **Strand size**: strands too fat or sparse for the texture → raise `density`. 5. **Export** with `?img=input/NAME&export=ascii,flow` (add any tuning parameters). Keep the tab in front until the title reads `done` (or `failed`). A 12 s loop at 1080 px wide takes about 10 minutes. Results: `out/NAME-ascii.mp4`, `out/NAME-flow.mp4`. 6. **Verify** before handing over (see Checks), then report the file paths and anything that looked weak. ## Parameters (URL) `img` (default: the sample), `mode` ascii|flow, `width` (default 1080), `height` (default: follows the image; with `width` set, the image is cropped to that shape), `focus` x,y 0–1 (which part to keep when cropping, default 0.5,0.5), `wind` auto|degrees, `light` degrees (default 130), `amp` sway (default 1), `density` (default 1), `loop` seconds (default 12), `fps` (default 30), `t` 0–1 freeze, `export` ascii,flow. **Wallpapers.** Set `width` and `height` to the screen's native resolution (e.g. 3840×2160 desktop, 1290×2796 phone) and choose `focus` from stills. Never render small and upscale: glyphs are 5×7 px and blur. A longer `loop` adds no variety: every motion term repeats a whole number of times per loop, so it only slows the motion down. ## Checks Run these on every export: 1. **Seamless loop**: `npm run check -- out/NAME-ascii.mp4` must print `✓ seamless` (last→first change no bigger than an ordinary frame step). 2. **Motion reads at phone size.** Scale two frames 0.5 s apart to 360 px wide and compare: PSNR should be about 25 dB or lower. If it is near 29+, motion is too subtle — raise `amp` (try 1.3–1.5). Users judge this on a phone, where small sway disappears. 3. **Colour matches the image.** Scale the ASCII frame and the source image to ~108 px wide and compare per brightness band: ASCII/source brightness ≈ 1.0–1.1, saturation ≈ the source's. Bright pixels must not be white-washed or neon. Do not "fix" dullness by pushing exposure or stroke saturation; that is what made earlier versions look blown-out and fluorescent. 4. **No black specks**: none should appear; if they do, a shader produced NaN (see Pitfalls). ## Pitfalls already solved — keep them solved - **NaN specks.** MSAA can extrapolate varyings slightly outside 0–1; `pow()` of a negative is NaN, which mipmapping spreads into black squares. Clamp before `pow`. Guard `atan(0, 0)`. - **Loop seam.** Every moving term must repeat a whole number of times per loop. Noise that drifts must use the periodic `pfbm` with an integer period on the drift axis. - **GLSL comments** must not end in a backslash (it continues the line and swallows the next one). `half` is reserved in GLSL — don't use it as a name. - **Brightness by angle.** Stroke glyphs are fitted so each weight lights the same pixel count at every angle; otherwise horizontal strands read darker than diagonal ones. - **Highlights.** Strokes keep their cell's own saturation and only ease toward warm cream at the very top. Whitening them loses the colour; boosting their saturation looks neon. - **Shadows.** Shadows keep thin strokes plus a glow so they read as dark colour, not black. ## Changing the look - Motion: `STRAND_VS` in `src/field.js` (`amp`, the `wave`/`sub`/`lean` mix, `own`). - Light: `sunDir`, `sunPool`, `poolTint` in `src/field.js`. - Glyphs and colour: `WEIGHTS` and the colour solve in `src/ascii.js`; the dot ramp in `src/font5x7.js`.
© yusen-dev · MIT · yusen-dev/living-ascii