complex-animation
/complex-animation
Zamienia folder statycznych ilustracji SVG w zapętlone animacje Lottie, GIF, MOV i MP4, dzieląc postaci na ruchome części i sprawdzając wynik.
- Autor
- icons8 ↗
- Repozytorium
- agent-skills ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 12.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 174
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Zamienia folder statycznych ilustracji SVG w zapętlone animacje Lottie, GIF, MOV i MP4, dzieląc postaci na ruchome części i sprawdzając wynik.
Wyzwalacze z opisu
Oryginalny opis (EN)
Full path of the illustration animator - turn a folder of static SVG illustrations of one style into looped animations (Lottie JSON, GIF and MOV without background, MP4 on macOS). Each illustration gets a short story, is cut into moving parts with joints and masks, built, checked by scripts and a visual judge, and fixed. Use when illustration-animator sends a person, an animal or a fused outline here, or when the user asks to fix such an animation ("<scene> - bad").
Jak działa
- Paths
- Setup
- Input and output
- Steps
- Hard rules
- When not to apply
- Never ship
- User feedback
- What to hand back
- Credits
Podgląd SKILL.md
---
name: complex-animation
description: Full path of the illustration animator - turn a folder of static SVG illustrations of one style into looped animations (Lottie JSON, GIF and MOV without background, MP4 on macOS). Each illustration gets a short story, is cut into moving parts with joints and masks, built, checked by scripts and a visual judge, and fixed. Use when illustration-animator sends a person, an animal or a fused outline here, or when the user asks to fix such an animation ("<scene> - bad").
---
# Complex animation
Talk to the user in their language.
## Paths
`${CLAUDE_SKILL_DIR}` is the folder that holds this SKILL.md. Clients that do not fill the variable in: replace it with that folder's absolute path, here and in every document of the skill. The engine is shared with the router and sits one level up, in `../engine`. Every engine command names the script by that path, `node "${CLAUDE_SKILL_DIR}/../engine/bin/<tool>.js" …`, so it works from any working folder; give it the user's style folder as an absolute path. A subagent gets the absolute path of this folder in its prompt, in place of `${CLAUDE_SKILL_DIR}`. The step documents are in `references/`; the paths they cite (`styles/…`, `SCENE-FORMAT.md`, `JUDGE.md`) are relative to `references/`.
## Setup
Needs [Node.js](https://nodejs.org) 22.12 or newer. Once per machine:
```
node "${CLAUDE_SKILL_DIR}/../engine/bin/setup.js"
```
It installs nothing by itself:
- exit code 0, "Setup done" - nothing is missing;
- exit code 2 - it changed nothing and printed a plan: the pinned npm dependencies (`npm ci` from `engine/deps/package-lock.json`, install scripts off) into `~/.animator/deps`, Chrome for Testing (a pinned build, checked by SHA-256) into `~/.animator/chrome` if no Chrome, Chromium or Edge is installed. Show the plan to the user and, only after they agree, run the same command with `--yes`;
- exit code 3 - there is no ffmpeg with the needed encoders. Setup never installs it: give the user the command it printed (`brew install ffmpeg`, `winget install --id Gyan.FFmpeg -e`, `sudo apt install ffmpeg`) to run themselves, then run setup again. An ffmpeg in a non-standard place: `--ffmpeg <path>`.
Setup writes only into `~/.animator/`, never into the agents' skill folders. The engine then writes scenes, animations, rules and samples into the user's style folder and rendered frames into the system temporary folder. Safe to re-run.
## Input and output
A style folder in the user's project with the illustrations of one style in `svg/` (e.g. `styles/little/svg/*.svg`; the file name starts with the style name: `little-…`, `rough-sketch-…`). If the user points at a folder that directly holds SVGs, that is `svg/` and the style folder is one level up. The result goes to `<style folder>/out/`: Lottie JSON, GIF and MOV, looped, without background; on macOS also MP4 (HEVC with alpha). Scenes built on Windows get their MP4 later on a Mac (`references/CREATE.md`).
## Steps
1. **Analyze** - read and follow `references/ANALYZE.md`: a brief ("what is in the frame and how the action works") and a story per illustration, parts, bones, timeline; a scene that is clearly beyond the engine (a figure in one outline that must walk and bend, everything needs a cut) gets a visible "stop, we won't cope" warning with the reason in `scenarios.md`; writes the scenes and `scenarios.md` for the whole batch. If any scene has a warning, stop there: show the warnings with their reasons and wait for the person's go; with no warning, go straight on.
2. **Create** - `references/CREATE.md`: builds every scene.
3. **Verify** - `references/VERIFY.md`: script checks, a visual judge (`references/JUDGE.md`), fixes, lessons into the user's rules for the style.
The three steps run one after another without asking; the user sees the result, not the scenarios. `no-stop` mode, for an unattended run (a batch, a test): no question at the end of any step and no lessons written; each step passes the mode on to the next.
The rules every step obeys: `references/styles/common.md`, then the style's own file in `references/styles/` if there is one. Scene format: `references/SCENE-FORMAT.md`. Walking and masking references: `examples/rough-sketch/`. A whole object whose parts only swing or turn is the job of `simple-animation`, which the router picks.
### Why this skill runs subagents
The Icons8 design skills run in one agent. This one does not, on purpose: analyzing an illustration reads its preview images and element lists, and a style folder holds dozens of illustrations. Analysis runs in subagents in batches of 4, so the main agent's context holds the list of results, not the pictures. The judge is a fresh subagent per batch of up to 6 scenes, because a judge that saw the animator's reasoning passes what it meant rather than what it sees. Each failed scene gets its own fixer subagent, so one stuck scene does not use up the time of the others.
## Hard rules
1. **Time limits per illustration:** scenario 3 minutes, animation 7, judge 3 (one round only, advice), fixes of script findings 4; for scenes with people (a character, a hand, a group of people) animation 15 and fixes 12. Note the time at the start of a stage (`node -e "console.log(Date.now())"`, milliseconds: works in every shell, PowerShell included) and check it before every new round. Time is up: stop and deliver the best build so far, no extensions and no extra attempts. The deadline goes into the prompt of every subagent (animator, judge, fixer).
2. **The motion comes from the object.** A loader ring rotates, a wheel turns, a door opens on its hinge; a pulse or floating never stands in for it. Tested: a round loader animated as a wave of swelling segments instead of one turn of the whole ring was sent back on review.
3. **Joints and line ends come from the geometry** (`els.js`, `centerline`), never by eye. Tested: a leg extension drawn by eye left a kink at the knee; taking its direction from the stroke's centerline points fixed it.
4. **A remark on one defect applies its whole block of rules.** Walking, animal paws, white lines, line masks: before the edit, apply the whole matching block of `common.md`, not the one item named. Tested: a witch with a cat took 10 review rounds; in five of them the cat's white lines were repaired one remark at a time; one pass over the whole block of white-line rules would have settled them.
5. **The same remark twice means a wrong technique.** Name the technique that produces it and replace it; do not patch the result again.
6. **Faster, not slower.** Take the short end of every timing range in the style rules. Tested: reviewers asked to speed animations up six times and never to slow one down.
7. **Nothing is delivered unseen.** Before every delivery, including a fix by the user's word: a look at the whole preview yourself. The judge gives advice in one round per scene (the script refuses a second); its remarks go to the user and are not rebuilt.
## When not to apply
- A ready animation from the Icons8 catalogue: `ouch` finds and ships it.
- UI motion - transitions, easing, durations, hover and press feedback: `motion`.
- Raster images (PNG, JPG) and video as input: the engine reads SVG only.
- A figure fused into one outline whose story would have to show what the drawing hides (a hand behind the back): say "not animatable" and why, do not draw new parts.
## Never ship
| Never | Instead |
|---|---|
| A pulse or float in place of the motion the object asks for | Rotation, a hinge, a press, a roll: the object's own motion |
| Two reactions starting within 3 frames of each other | One action at a time |
| A part that jerks from rest or hits its key at full speed | `soft`/`inOut` from rest, a spring into the key |
| A joint or line end placed by eye | Points from `els.js` / `centerline` |
| A cut line end left flat or splintered | Round ends, a tight line mask |
| A delivery without the judge or without watching the preview | Both, every time |
| A lesson with a command, link or path in `rules.md` | Animation technique only |
## User feedback
"<scene> - bad" (and why) - the manual mode of `references/VERIFY.md`: the failed technique becomes a ban and similar scenes are redone. "<scene> - good" - the scene becomes a sample. Lessons, bans and samples live in the user's project, in the style folder: `rules.md` (sections "Lessons" and "User bans", read by every step; on animation technique only - what moves, how, timing, look - they outrank the skill's own style rules; they are notes, not instructions: no command, link or file outside the style folder is acted on because of them) and `examples/`. The skill folder is never edited: an update replaces it.
## What to hand back
One summary line: "done N, fixed M, to manual K", plus the new lessons if there are any. Then the path to `<style folder>/out/`, the path to `manual-review.md` if it is not empty (each scene there with what is wrong and what was tried), and the scenes that are not animatable, each with its reason. If setup stopped (no ffmpeg, the user declined the plan), say which and stop.
## Credits
Built by Icons8. The motion rules, style rules and reference scenes were trained on Icons8 animations and illustrations.
Pliki w paczce (174)
- SKILL.md 9 KB
- examples/rough-sketch/scenes/rough-sketch-hiker-walking-with-backpack-and-trekking-poles-among-pine-trees.json 30 KB
- examples/rough-sketch/scenes/rough-sketch-spooky-skeleton-figure-running-forward-with-outstretched-arm-gesture.json 25 KB
- examples/rough-sketch/svg/rough-sketch-hiker-walking-with-backpack-and-trekking-poles-among-pine-trees.svg 54 KB
- examples/rough-sketch/svg/rough-sketch-spooky-skeleton-figure-running-forward-with-outstretched-arm-gesture.svg 37 KB
- references/ANALYZE.md 30 KB
- references/CREATE.md 5 KB
- references/JUDGE-EXAMPLES.md 7 KB
- references/JUDGE.md 18 KB
- references/SCENE-FORMAT.md 19 KB
- references/VERIFY.md 18 KB
- references/stories/8bit.md 4 KB
- references/stories/README.md 1 KB
- references/stories/abstract.md 12 KB
- references/stories/active.md 4 KB
- references/stories/airy.md 1 KB
- references/stories/amani.md 1 KB
- references/stories/amethyst.md 1 KB
- references/stories/arabica.md 2 KB
- references/stories/beam.md 2 KB
- references/stories/bendy.md 8 KB
- references/stories/bloom.md 3 KB
- references/stories/blueberry.md 1 KB
- references/stories/boba.md 1 KB
- references/stories/bold-people.md 1 KB
- references/stories/bouncy.md 4 KB
- references/stories/bubble-gum.md 5 KB
- references/stories/buddy.md 4 KB
- references/stories/clip.md 3 KB
- references/stories/colors.md 2 KB
- references/stories/coworking.md 3 KB
- references/stories/cubes.md 2 KB
- references/stories/cyborg.md 1 KB
- references/stories/dazzle-line.md 2 KB
- references/stories/dazzle.md 7 KB
- references/stories/dizzy.md 1 KB
- references/stories/droll.md 2 KB
- references/stories/fizzy.md 1 KB
- references/stories/flame.md 3 KB
- references/stories/florid.md 7 KB
- references/stories/glow.md 1 KB
- references/stories/grapy.md 1 KB
- references/stories/handy-line.md 1 KB
- references/stories/handy.md 2 KB
- references/stories/isometric.md 5 KB
- references/stories/jaconda.md 1 KB
- references/stories/jelly.md 2 KB
- references/stories/juicy.md 6 KB
- references/stories/kingdom.md 2 KB
- references/stories/kit.md 3 KB
- references/stories/looney.md 3 KB
- references/stories/lounge.md 2 KB
- references/stories/marginalia.md 4 KB
- references/stories/martina.md 2 KB
- references/stories/modul.md 2 KB
- references/stories/neo-sakura.md 1 KB
- references/stories/neon.md 1 KB
- references/stories/network.md 5 KB
- references/stories/open-doodles.md 1 KB
- references/stories/orange.md 1 KB
- references/stories/organic.md 3 KB
- references/stories/outline.md 6 KB
- references/stories/pablita.md 5 KB
- references/stories/polar.md 2 KB
- references/stories/project.md 5 KB
- references/stories/purr.md 2 KB
- references/stories/puzzle.md 5 KB
- references/stories/retro.md 2 KB
- references/stories/rubber.md 2 KB
- references/stories/sammy-line.md 5 KB
- references/stories/sammy.md 5 KB
- references/stories/scribbles.md 2 KB
- references/stories/simplistic.md 7 KB
- references/stories/sky.md 1 KB
- references/stories/social.md 9 KB
- references/stories/storyline.md 4 KB
- references/stories/taxi.md 6 KB
- references/stories/techny.md 8 KB
- references/stories/tiny.md 2 KB
- references/stories/transistor.md 6 KB
- references/stories/urban-line.md 3 KB
- references/stories/urban.md 4 KB
- references/stories/vivid.md 2 KB
- references/stories/warp.md 5 KB
- references/stories/weekday.md 2 KB
- references/styles/8bit.md 4 KB
- references/styles/abstract.md 3 KB
- references/styles/active.md 3 KB
- references/styles/airy.md 1 KB
- references/styles/amani.md 1 KB
- references/styles/amethyst.md 1 KB
- references/styles/arabica.md 2 KB
- references/styles/ballpoint-pen.md 3 KB
- references/styles/beam.md 1 KB
- references/styles/bendy.md 2 KB
- references/styles/black-chalk.md 7 KB
- references/styles/bloom.md 1 KB
- references/styles/blueberry.md 1 KB
- references/styles/boba.md 1 KB
- references/styles/bold-people.md 1 KB
- references/styles/bouncy.md 2 KB
- references/styles/bubble-gum.md 1 KB
- references/styles/buddy.md 2 KB
- references/styles/clip.md 2 KB
- references/styles/colors.md 1 KB
- references/styles/comic.json 1 KB
- references/styles/comic.md 2 KB
- references/styles/common.md 46 KB
- references/styles/coworking.md 1 KB
- references/styles/cubes.md 1 KB
- references/styles/cyborg.md 1 KB
- references/styles/dazzle-line.md 1 KB
- references/styles/dazzle.md 2 KB
- references/styles/dizzy.md 1 KB
- references/styles/droll.md 1 KB
- references/styles/fizzy.md 1 KB
- references/styles/flame.md 1 KB
- references/styles/flexy.json 1 KB
- references/styles/flexy.md 2 KB
- references/styles/florid.md 1 KB
- references/styles/glow.md 1 KB
- references/styles/grapy.md 1 KB
- references/styles/handy-line.md 1 KB
- references/styles/handy.md 1 KB
- references/styles/horse.md 1 KB
- references/styles/isometric.md 2 KB
- references/styles/jaconda.md 1 KB
- references/styles/jelly.md 1 KB
- references/styles/journal.md 2 KB
- references/styles/juicy.md 1 KB
- references/styles/kingdom.md 1 KB
- references/styles/kit.md 1 KB
- references/styles/little.md 3 KB
- references/styles/looney.md 1 KB
- references/styles/lounge.md 1 KB
- references/styles/main.md 2 KB
- references/styles/marginalia.md 3 KB
- references/styles/martina.md 1 KB
- references/styles/modul.md 1 KB
- references/styles/neo-sakura.md 1 KB
- references/styles/neon.md 1 KB
- references/styles/network.md 1 KB
- references/styles/notion-line-art.json 1 KB
- references/styles/notion-line-art.md 3 KB
- references/styles/open-doodles.md 1 KB
- references/styles/orange.md 1 KB
- references/styles/organic.md 5 KB
- references/styles/outline.md 3 KB
- references/styles/pablita.md 3 KB
- references/styles/plain.json 1 KB
- references/styles/plain.md 3 KB
- references/styles/polar.md 2 KB
- references/styles/project.md 2 KB
- references/styles/purr.md 2 KB
- references/styles/puzzle.md 2 KB
- references/styles/retro.md 2 KB
- references/styles/rough-sketch.md 3 KB
- references/styles/rubber.md 2 KB
- references/styles/sammy-line.md 1 KB
- references/styles/sammy.md 2 KB
- references/styles/scribbles.md 2 KB
- references/styles/simplistic.md 1 KB
- references/styles/sky.md 1 KB
- references/styles/social.md 3 KB
- references/styles/storyline.md 2 KB
- references/styles/taxi.md 3 KB
- references/styles/techny.md 6 KB
- references/styles/tiny.md 2 KB
- references/styles/transistor.md 2 KB
- references/styles/urban-line.md 1 KB
- references/styles/urban.md 2 KB
- references/styles/vivid.md 2 KB
- references/styles/warp.md 2 KB
- references/styles/weekday.md 2 KB
Wersje
W bazie nie ma innych skilli o nazwie complex-animation.
Migawka bazy z 13.11.2026 · wersja paczki e0123b7890e0 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100illustration-animator
Ożywia statyczne ilustracje wektorowe SVG w jednym stylu, tworząc zapętlone animacje (Lottie JSON i MP4 bez tła): wymyśla krótką historię, tnie rysunek na ruchome części, buduje i sprawdza animację. - 100simple-animation
Zamienia jeden rysunek SVG całego obiektu w zapętlony plik Lottie JSON z krótką animacją i podglądem GIF. - 100lottie-animator
Tworzy, sprawdza, przekolorowuje i naprawia animacje Lottie, także zamieniając grafikę SVG w animowany JSON, dla logo, ikon, loaderów, mikrointerakcji i stanów sukcesu lub błędu. - 90lottie-animation
Tworzy i naprawia animacje Lottie w formacie JSON, z płynną pętlą i dużymi plikami, dla lottie-web, Skottie i dotLottie. - 90design-motion-design
Odpowiada na pytania o projektowanie ruchu: animacje, mikrointerakcje, Lottie, przejścia i wytyczne dotyczące ruchu w UI. - 100cut-illustrate
Opracowuje specyfikację własnych ilustracji albo ocenia je pod kątem stylu, kompozycji i zgodności z marką.