Communitygithub.com

dsauce/stickman-kino

Animez un film Stickman Kino - écrivez scenes.js à partir de film.json/storyboard en utilisant le moteur stickman (stick figures riggés avec 58 poses et IK, ~190 accessoires, graphiques et diagrammes, texte cinétique, légendes, mouvements de caméra, effets, environnements, thèmes, transitions), synchronisé avec la voix-off, puis vérifiez avec check + snapshots. Utilisez-le pour toute chorégraphie de scène, mouvement, mise en page ou travail de correction visuelle sur un film Stickman Kino.

Qu'est-ce que stickman-kino ?

Cette compétence pour les agents IA vous permet de créer et d'animer des films Stickman Kino en écrivant un fichier scenes.js basé sur un storyboard film.json. Elle exploite le moteur SM, un puissant outil JavaScript intégré au navigateur qui gère des stick figures articulés (58 poses, cinématique inverse), environnements, transitions, et une vaste bibliothèque de près de 190 accessoires et d'effets. Le système de synchronisation vocale intégré, via la fonction sc.cue(), permet d'aligner les animations sur les mots prononcés par le narrateur, garantissant un rendu professionnel. La compétence impose un flux de travail rigoureux : après avoir écrit les scènes, vous exécutez les commandes 'stickman check' et 'stickman snapshot' pour valider le code et inspecter visuellement chaque plan (contacts sheets PNG). Ce processus itératif assure qu'il n'y a pas d'erreurs de script, de chevauchements gênants, de figures flottantes ou de problèmes de timing, vous permettant de produire des films d'animation soignés directement depuis l'agent.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dsauce/stickman-kino/tree/HEAD/skills/stickman-animator

Demander à votre IA préférée

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

Documentation

Animateur Stickman

Vous écrivez scenes.js - une film.scene(id, sc => { … }) par clip dans film.json, mêmes ids, même ordre. Tout est du JavaScript navigateur standard utilisant le moteur global SM. Lisez references/api.md (antisèche complète) et references/cookbook.md (recettes copier-coller) avant d'écrire.

Modèle mental

  • Temps local. Dans une scène, chaque temps est en secondes depuis le début du clip. sc.dur = la durée du clip.
  • Chaînable. Chaque action retourne le moment où elle se termine : const t = bob.walkTo(900, 0.2); bob.wave(t);
  • Synchronisé à la voix. sc.cue("mot") = estimation du temps local où le narrateur dit ce mot (sc.cue(["mot", 1]) = 2ème occurrence, sc.cue(0.5) = à mi-parcours de la VO). Placez le visuel sur ou juste avant le mot (sc.cue("idée") - 0.15).
  • Calques. world (environnement) → back (accessoires) → figures → front (accessoires devant les figures) → ui (espace écran, ignore la caméra) → top (transitions). Passez { layer: "front" } / "ui" aux accessoires.
  • Coordonnées. Le canvas est sc.W × sc.H (1920×1080, 1080×1920 ou 1080×1080). sc.groundY est le sol (80 % en bas en paysage, 74 % en portrait). Les figures se tiennent sur y = leurs pieds.
  • Objets. Les accessoires, textes, graphiques, formes sont des Thing : .pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show.
  • Caché-jusqu'à-l'entrée. Créez avec { hidden: true } puis .pop(t) ; le texte est caché jusqu'à .in(t, fx).

Squelette de scène

const film = SM.film();                       // le thème/format viennent de film.json

film.scene("accroche", sc => {
  sc.enter("fondu");                           // optionnel, correspond à la sortie précédente
  sc.ground();                                // ligne de sol (style : "grass" | "none")
  const bob = sc.figure({ x: -150, visage: "points" });        // ou sc.character("zeke", {...})
  const t1 = bob.walkTo(sc.W * 0.35, 0.2);
  bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("ceci"));
  const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", valeur: 4 }, { label: "2025", valeur: 9 }] });
  chart.grow(sc.cue("a augmenté"));
  sc.text("Revenu [doublé]", { x: sc.W * 0.68, y: 150, taille: 80 }).in(sc.cue("doublé") - 0.1, "mots");
  sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3);   // lent zoom avant
  sc.exit("essuyer-gauche");
});

Intros & Outros

Les clips qui déclarent "intro" / "outro" dans film.json se construisent eux-mêmes. Vous n'avez pas besoin d'une scène pour eux. Pour ajouter des suppléments (accessoires jaillissant autour du titre, une figure qui salue le CTA), écrivez la scène et appelez le preset vous-même ; la version automatique est alors ignorée :

film.scene("intro", sc => {
  const t = sc.intro("countdown", sc.clip.intro);          // retourne quand le titre s'est posé
  sc.prop("fusée", { x: 1500, y: 300, taille: 120, calque: "ui", cache: true }).pop(t - 0.8);
  sc.exit("essuyer-gauche");
});
film.scene("outro", sc => {
  sc.enter("fondu", { couleur: "bg" });
  sc.outro("kino", sc.clip.outro);
  sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});

Règles de mise en scène (ce qui rend le rendu beau)

  1. Quelque chose change toutes les 2-3 s. Planifiez 3 temps forts par clip ; comblez les trous avec une poussée de caméra, un clignement/hochement de tête, un balancement d'accessoire, une mise en évidence.
  2. Mettez en scène avant d'animer. Décidez où vivent la figure, l'accessoire principal et le texte (tiers en 16:9 ; empilés en 9:16). Gardez le texte loin de la tête de la figure et des autres textes.
  3. Les figures agissent, ne restent pas immobiles. Utilisez des gestes qui ont du sens : point vers ce qui est discuté, think avant une idée, surprise lors d'une révélation, shrug pour un mythe, celebrate pour une victoire, push/climb/runTo pour un effort.
  4. Une entrée focale à la fois ; espacez de 0.1-0.2 s lorsque plusieurs choses apparaissent.
  5. Faites correspondre les sorties et les entrées entre les clips (même type de transition) ou cut dans le mouvement (même pose/position d'objet).
  6. Les accents portent du sens : "a1" problème, "a2" solution, "a3" récompense. Passez des noms de couleurs : "a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper" ou hexadécimal.
  7. Vérité du sol : les figures se tiennent sur sc.groundY (ou une surface que vous avez calculée) ; les accessoires qui reposent sur le sol utilisent y = sc.groundY - taille*0.4.
  8. Portrait : figure taille: 420-460, accessoires 200-300, texte 70-120, gardez la bande centrale occupée et les légendes basses.

Vérifier (boucle obligatoire)

  1. stickman check <répertoire> → doit afficher Check passed. page_error = votre JS a levé une erreur ; corrigez-la.
  2. stickman snapshot <répertoire> (ou --at aux moments clés) → ouvrez snapshots/contact-sheet*.jpg et les PNG et regardez. Corrigez : coupures, chevauchements, figures flottantes, moments vides, textes illisibles, bras traversant les têtes (ajustez les surcharges de pose), mauvaises couleurs d'accent.
  3. Réexécutez jusqu'à ce que ce soit propre, puis rendez.

Pièges

  • Planifiez chaque figure chronologiquement. celebrate() planifie un retour à stand à +1.0 s ; passez { hold: true } si vous le poserez à nouveau peu après.
  • bob.hold(accessoire) attache à la main droite et reste droit ; créez avant utilisation et .pop(t).
  • Balisage de texte : "[mots accentués]" colore une phrase avec l'option accent (par défaut a2).
  • Les graphiques comptent les nombres avec des pas discrets ; donnez prefix/suffix/decimals dans les options du graphique.
  • N'utilisez pas Math.random/Date/setTimeout. Utilisez SM.rng(seed).
  • GSAP brut est autorisé : sc.tl.to(el, vars, sc.T(tempsLocal)) - gardez-le comme une fonction pure du temps.

Skills associés