line-art-animation
Skill811 starsChanged 6 days agoMITView on GitHub
Build animated line-art components in SVG and TypeScript — thin ink lines on paper, people and animals that walk, run, cycle and react, scenes with wind, lit windows and a day/night cycle, exported to video if needed. Use this whenever someone asks for a line art (or ink, pen, doodle, hand-drawn) animation, an animated illustration or scene component, little characters doing everyday things, a living street/village/shop/park, a day-night cycle illustration, "make it like this clip" for a drawn animation, or a video of such a component — even if they never say "SVG" or "line art".
1 other project uses a version of this.
Adopted by
Most recently taken up by
- insightflo/edu-deck-skillsword for word, first seen Nov 15, 2026
Other versions1 project uses a version of this.
Word for word · 1
- insightflo/edu-deck-skills★ 7100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Read the example that's closest to the request before writing anything.
- Very specific: line 31
Pin the look: before anything moves. Read references/style.md.
- Distinctive: line 73
No buttons inside the scene.
- Distinctive: line 74
New means new: If the brief is "like this but new", keep the medium, pen, proportions and timing feel.
- Very specific: line 96
All run with Node ≥ 22.18 (TypeScript is stripped natively) plus ffmpeg.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Line-art animation
Animated illustration components: everything is drawn with one thin pen on paper, built live in SVG from TypeScript, so it stays crisp at any size, responds to the pointer, and can be stepped frame by frame for checking or video export.
This skill ships a small library (lib/), two examples (examples/walker, a single
figure in ~150 lines; examples/village, a full scene) and tools (scripts/).
Read the example that's closest to the request before writing anything.
How people judge this work
They look at it like an animator would: frame by frame, at zoom, against life or against a reference. These were all rejected in practice, and each has a rule below:
- walks that bob on a sine wave, feet that slide, gaits sped up to fit a time-lapse
- limbs drawn as closed tubes; ruler-straight lines; rigid clothes that ignore the legs
- a whole set of components built in one go that all look alike ("AI slop")
- interactions that feel like UI instead of the world reacting
- a page whose background changes with the scene ("looks like a video, not a component")
- reusing characters from a reference clip when asked for something new
- leftover props nobody asked for (they asked to remove hanging laundry)
Workflow
- Pin the look before anything moves. Read
references/style.md. Decide the pen weight, paper colour, figure proportions and the one or two flat accent colours. - Set up the project. Copy
lib/into the project (it's four dependency-free.tsfiles) and use Vite + TypeScript (package.json,tsconfig.jsonandvite.config.tsin this repo show the setup). Components are plain DOM/SVG — no framework needed. - Build one figure or one corner first and show it (screenshot or a short clip, next to the reference if there is one). Get a yes before building the rest. A full set built at once comes back as generic; one good piece shows the bar.
- Make it move with
references/motion.md:gait()for walking and running,spring()/pendulum()for anything attached or hanging, keyed poses withcurve()orsequence()for gestures. Never animate a figure with free sines. - Compose the scene with
references/scenes.md: a self-contained card on a fixed page background, layers, a time-of-day palette fromlib/daynight.ts, lights, wind, people arriving on schedules, interactions that are reactions. - Verify with
references/verify.mdbefore showing anything: typecheck,?debugstepping, zoomed frame strips of every moving thing, interactions triggered and stepped through, 60 fps in a real tab. - If there's a reference clip to match, follow
references/matching.md— measure timing and poses from the clip instead of guessing, and check with an overlay. - If they want a video, follow
references/video.md(deterministic headless capture withscripts/capture.ts, then ffmpeg).
Rules that make it work
- Limbs are two open strokes.
limb()draws a paper-filled band between two pen lines that stop short of each other at the far end. This is the style's signature. - Lines curve. Joints are rounded, edges bow slightly, nothing is ruler-straight.
- Draw each figure in its own space — ~95 units tall, feet on y = 120, facing +x,
standing at x = 40 — and place it with
place(g, x, y, dir, scale). Proportions, pen weight and the gait presets all assume this space. - Clothes are drawn around the skeleton. Solve the legs (even if hidden), then draw the coat or kimono hem from the forward knee and the ankles so the cloth opens and closes with the stride. Sleeves, scarves and bags swing on springs.
- Feet are planted. Move a walker by exactly
gait.speed × scaleper second and the stance foot stays still on the ground. Don't speed a gait up to match a compressed clock; compress arrivals instead. - Ink is
currentColor, paper is.pp. Retint the whole drawing withapplyPalette()(day: dark ink on warm paper; night: pale ink on indigo, warm windows). Solid-colour limb fills must usesolid(), or the paper CSS wins. - The component is a card. The page around it never changes colour.
- Interactions are the world reacting: a person bows or tips a hat, a cat wakes and stretches, a lantern swings, birds scatter, a fish jumps. Pointer movement is wind. No buttons inside the scene; a single faint hint line is enough.
- New means new. If the brief is "like this but new", keep the medium, pen, proportions and timing feel; invent the characters, activities and props.
Library at a glance
| module | what it gives you |
lib/ink.ts | pen shape blot paint limb solid joint hang curve shoe place toScene inkDefs run |
lib/gait.ts | gait({ kind: 'walk' | 'shuffle' | 'run', …overrides }) → { speed, period, pose(phase, go) } |
lib/motion.ts | spring pendulum pointerWind sequence seeded wobble ease minJerk … |
lib/daynight.ts | palette(τ) → sky, paper, ink, lamp, night, sunset; applyPalette nightTint |
run(draw) drives everything with draw(t, dt). Two URL flags matter for checking:
?t=1.25 freezes time; ?debug disables rAF and exposes window.__step(seconds)
for exact stepping (background and headless tabs throttle rAF, so always verify in debug mode).
Scripts
scripts/capture.ts <url?debug> <outDir> <frames> <fps> [w] [h] [setupJs] [frameJs]— deterministic PNG frames from headless Chromescripts/clip.ts period|blobs …— loop length of a region; dark-blob tracking per framescripts/frames.sh <clip> x y w h outDir— grid-overlaid frames for reading poses off a clip
All run with Node ≥ 22.18 (TypeScript is stripped natively) plus ffmpeg; capture.ts
finds a local Chrome/Chromium or uses $CHROME.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

