Communitygithub.com

VisualxIntelligence/motion-tools-and-skills

Créez des vidéos de dessins animés peints à l'aquarelle et à l'encre (MP4) avec du code — p5.js + p5.brush rendus image par image dans Chrome sans tête, encodés avec ffmpeg — avec Clawd ou n'importe quel personnage.

Qu'est-ce que motion-tools-and-skills ?

Cette compétence permet de générer des courts métrages d'animation entièrement par code, en utilisant un pipeline basé sur p5.js, p5.brush, Chrome sans tête et ffmpeg. Chaque image est une fonction pure du temps `t`, ce qui permet un rendu parallèle et reproductible. Le processus inclut la création d'un storyboard, la construction scène par scène, le rendu et la révision via des planches contacts ou des bandes, et l'encodage final en MP4 avec ou sans audio. La compétence fonctionne sur macOS (détection automatique de Chrome) et peut être adaptée à d'autres plateformes en spécifiant le chemin de Chrome. Elle supporte la synchronisation musique/paroles, les boucles pour GIF, et la division de longues vidéos en sous-agents. Les règles clés incluent l'utilisation exclusive des fonctions `paint()` et `inkLine()` (pas de formes p5 brutes), l'absence de texte sauf pour le karaoké, l'obligation d'avoir un événement par plan, et des transitions entre chaque plan.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VisualxIntelligence/motion-tools-and-skills/tree/HEAD/skills/painted-animation

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Animation peinte

Une méthode pour créer de courts dessins animés entièrement en code, distillée de JohnHeibel/PDoomVideo (un clip musical de 156 s peint par Claude Opus) et de son kit généralisé ClaudeAnimationBase (MIT), qui est inclus ici dans template/.

Comment ça marche : chaque image est une fonction pure du temps t. studio.html charge p5.js + p5.brush et vos fichiers de scène ; chaque plan peint l'image entière en 1920×1080 avec des remplissages aquarelle et des lignes d'encre bouillonnantes. render.mjs pilote Chrome sans tête pour rendre des planches contacts pour la révision, ou chaque image en parallèle, et ffmpeg encode le MP4 (avec audio si fourni).

Flux de travail

0. Structure de base

bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir>        # ajoutez --keep-demo pour conserver la scène d'exemple connectée

Ceci copie le modèle, déconnecte la scène d'exemple, exécute npm install et vérifie node / ffmpeg / Chrome. Ensuite, lisez <project-dir>/ANIMATION_GUIDE.md en entier avant de concevoir quoi que ce soit : il contient les règles, les principes d'animation et l'API complète du moteur / Clawd. Consultez docs/emotions.jpg et docs/views.jpg (les fiches modèles) avec l'outil Read.

Pour un clip musical ou toute chose plus longue qu'environ 20 s, lisez aussi references/music-video.md. Pour un vidéoclip de paroles, demandez d'abord le fichier de la chanson et un LRC, et mesurez le tempo avec scripts/beat_grid.py : les lignes sont généralement plus rapides que vous ne le pensez.

1. Storyboard avant le code

Écrivez STORYBOARD.md dans le projet (format dans le guide : logline, arc monde + palette, motif, arc émotionnel du personnage, puis plans avec lectures — la liste chronologique de ce que le spectateur doit comprendre). Exemple concret : examples/xiaozhen/ (un vidéoclip de paroles de 31 s : storyboard et code complet de la scène).

Montrez le storyboard à l'utilisateur et laissez-le réagir avant de construire, à moins qu'il n'ait dit d'aller de l'avant.

2. Construire plan par plan

  • Définissez duration, bpm, offset (et audio) dans src/config.js.
  • Un fichier par scène/chapitre encapsulé dans une IIFE dans src/scenes/, se terminant par shots([[t0, fn], ...]) ; ajoutez son <script> à studio.html.
  • Blaquez d'abord les poses clés, vérifiez-les en tant qu'images fixes, puis ajoutez le mouvement entre elles.

3. Rendre et regarder — chaque plan, plusieurs fois

On ne peut pas voir le mouvement en lisant du code. Depuis le répertoire du projet :

node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg        # images clés
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg                             # chaque image d'un moment
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg   # détail en pleine résolution

Ouvrez chaque image avec Read et vérifiez-la réellement par rapport à la liste de révision du guide : l'événement est clair ? le personnage est assez grand ? les lectures sont chronométrées pour qu'un spectateur novice les comprenne ? anticipation / suivi, pas de à-coups ? les pieds et les accessoires tenus touchent-ils le sol ? des transitions à chaque jointure ? pas de texte, pas de 3D, pas de noir/blanc pur, pas de lueurs brouillonnes ? Corrigez et regardez à nouveau. Budget : ≥ 1 planche par plan, une bande par mouvement clé et transition, un recadrage par visage porteur de l'histoire.

4. Rendre la vidéo

node render.mjs --clip --out=out/video.mp4                                   # vidéos courtes, un travailleur
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3]   # longues, parallèle + reprisable

Signalez le chemin de sortie, la durée et le ms/image. Proposez open out/video.mp4.

Les règles les plus importantes

Ce sont les règles du guide condensées ; le guide fait foi.

  1. Médium artisanal. Uniquement paint() / inkLine() (p5.brush) — jamais de rect/ellipse/fill p5 bruts. Plat 2D uniquement : les rotations passent par des vues clés dessinées (turn(), spinView()), jamais de projection 3D. Lumière via glow() (additif), car le mélange de pigments fait que le jaune sur le bleu devient vert.
  2. Pas de texte. Pas de légendes, d'étiquettes, de panneaux ou de bulles de dialogue ; montrez-le à la place. Les réactions sont des émoticônes peintes (!, sueur, cœurs…). La seule exception est le karaoké dans un vidéoclip de paroles, et au maximum quelques gros effets sonores.
  3. Quelque chose se passe dans chaque plan — un événement, cause → réaction, des mises en place qui paient.
  4. Du temps pour le spectateur. Listez les lectures de chaque plan ; une lecture à la fois ; actions rapides, significations tenues ; guidez l'œil ; les lectures déterminent la durée du plan. C'est là que l'animation générée échoue le plus.
  5. Vivant. Rien n'est statique (idles de feel(), caméras flottantes, ébullition) ; les visages changent avec emotions() jamais par échange ; le personnage est grand (plan moyen u≈20–28, gros plan 40–70) ; tout suit le rythme.
  6. Transitions à chaque jointure, choisies pour s'adapter à l'histoire (essuyage de pinceau, iris / iris en forme, panoramique fouetté, cut on action, raccord dans le mouvement, passage de caméra).
  7. Un tout. Un seul monde, un arc de couleurs, un fil émotionnel, des scènes liées, une fin qui rime avec le début.

Pièges du moteur

  • Fonctions pures de t. Les images sont rendues en parallèle et dans le désordre : pas d'état entre les images, pas de Math.random(), pas de physique image par image. Utilisez hash(i) pour l'aléatoire stable, jit() pour l'ébullition.
  • boilSeed(key) avant chaque élément de fond/prop séparé, sinon un objet en mouvement fait que tout ce qui est dessiné après lui rebouillonne à chaque image (gigue).
  • Ne nommez pas les globales comme celles de p5. p5 définit line, OVERLAY, text, color, scale, … comme globales ; une function line() au niveau supérieur échoue avec Cannot redefine property et la page ne devient jamais prête (le rendeur expire). Gardez les aides à l'intérieur de l'IIFE de la scène ou donnez-leur des noms distincts.
  • Superposition dans les portes, fenêtres et écrans : dessinez ce qui est à l'intérieur, puis repeignez le mur/cadre environnant par-dessus, de sorte que rien de plus large que l'ouverture ne se voie à l'extérieur (l'inDoor du train + les jambages de porte, les pièces du cadre TV).
  • Un NaN dans une liste de points provoque Failed to construct 'OffscreenCanvas' — protégez la géométrie dégénérée.
  • Sous un zoom de caméra ≳ 2, les grandes formes perdent leurs contours ; l'épaisseur des contours s'adapte au zoom, donc réduisez sw dans les gros plans.
  • Coût = nombre de remplissages et de traits. Visez ≤ ~1.5–2.5 s/image (le journal imprime ms/image). Préférez moins de formes, plus grandes. Sur les machines sans GPU réel, les remplissages aquarelle sont lents — envisagez moins de formes fill, ou --soft-gl en dernier recours.
  • macOS : le rendeur utilise --use-angle=metal et trouve /Applications/Google Chrome.app automatiquement ; sinon passez --chrome=<path>.

Adaptation

  • Clawd est la star par défaut, pas une obligation. Les nouveaux personnages, accessoires et émotions sont dessinés avec les mêmes outils (paint, ribbon, through, glow) et restent cohérents entre les plans ; les nouvelles émotions vont dans EMO dans src/clawd.js.
  • src/karaoke.js (modèle) ajoute un karaoké mot par mot pour les vidéoclips de paroles via le crochet window.overlayHook dans core.js.
  • LOOPS.name = t => {...}; LOOPS.name.len = 4; + node render.mjs --loop=name --png crée une boucle sans couture pour les GIF (ffmpeg -i out/loop_name/f%04d.png …).
  • Un effort de raisonnement plus élevé tend à donner des scènes plus extravagantes et détaillées.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

VisualxIntelligence/motion-tools-and-skills

Make kinetic-typography motion reels (MP4) in code: showreels, portfolio or work reels, product promos, intro films, "motion design"-style videos with bold condensed type, HUD micro-type, black/cream/lime palette, three.js generative layers (particle terrain, liquid marble, chrome knot, particle clouds), shape-continuity transitions and a synthesized, beat-locked score. Canvas 2D + WebGL rendered frame by frame in headless Chrome, encoded with ffmpeg. Use when the user asks for a reel, showreel, motion-graphics / kinetic-type video, a "Work Reel" in this style, or to extend/re-cut the Work Reel ’26.

VisualxIntelligence/motion-tools-and-skills

Direct and produce a short film made entirely in code, in one of the styles of the Lemo-Opuscar library (e.g. Impasto Oil Painting 油画厚涂, Watercolor Brush 水彩笔刷, Chinese Ink Wash 中国水墨, Ukiyo-e 浮世绘, Whiteboard Explainer 白板讲解). Use when the user asks for a video, film, short, promo, explainer or animation (视频、短片、动画、宣传片) in a named style; when they want a film made about their own topic and haven't chosen a style (help them choose); or when they ask which film styles there are. Not for editing or converting existing video files.

VisualxIntelligence/motion-tools-and-skills

Create and revise animated character music videos from a supplied song and creative prompt, with researched storyboards, Fal character and video generation, p5 motion graphics, audio editing, and Swift VFX. Use for full music videos or revisions to their characters, scenes, animation, sound, and effects.

Skills associés