Communitygithub.com

motion-qa

Vérifie les images d'un montage papier par rapport au Style DNA et au storyboard. Génère des planches-contact à plusieurs timestamps, exécute la checklist complète, puis rédige le résumé de livraison.

Qu'est-ce que motion-qa ?

Cette compétence effectue un contrôle qualité visuel automatisé pour les animations de type « papercut » (découpage papier). Elle compare les rendus d'un projet Remotion (ou Kyfram) avec le Style DNA défini dans la bibliothèque de styles, ainsi qu'avec le storyboard. L'utilisateur fournit un nom de projet et des timestamps ; l'outil génère des planches-contact en extrayant quelques images clés, puis applique une checklist exhaustive : chaque objet doit ressembler à du papier (grain, ombre portée, pas de contours ni de dégradés), la caméra doit être fluide, la bannière fixe et tapée, les légendes positionnées correctement, etc. La compétence prend en charge les projets basés sur Remotion (nécessitant l'installation standard) et les projets Kyfram (via le skill `kyfram`). Elle impose des règles strictes comme l'absence de rendus simultanés, un maximum de deux rounds de corrections par scène, et une vérification finale du fichier `motion-principles.md`. Une fois la checklist validée, elle génère un résumé de livraison listant les scènes, leurs durées, et les éléments encore en placeholder (voix, musique, effets sonores, assets). Les corrections sont renvoyées vers les compétences `motion-build` ou `motion-voice`.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-qa

Demander à votre IA préférée

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

Documentation

QA Papercut

Compare les images pour le style, pas pour le contenu, par rapport au Style DNA et au storyboard. Exécutez-la par scène pendant la construction, et une fois sur l'ensemble du montage avant le rendu final.

Pré-vol

  • Installation : Standard ou Complète. Les images nécessitent un projet scaffoldé avec Remotion, et les planches-contact nécessitent Python avec numpy et Pillow ($MOTION_PY). Éléments manquants : ./install.sh --doctor, puis motion-setup.
  • Un projet kyfram n'a pas besoin de Remotion : invoquez le skill kyfram avant d'inspecter ou de corriger la sortie d'une scène Kyfram. qa.sh extrait ses images des segments par scène mis en cache (core/tools/kyfram_qa.py), donc effectuez un rendu avec core/tools/render.sh avant le QA. Tout ce qui suit s'applique sans changement.
  • Bibliothèque : $MOTION_LIB, sinon la ligne MOTION_LIB= dans ~/.config/motion-explainer/config.env, sinon demandez une fois.
  • Lisez d'abord : le Style DNA dans $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md section 2, et la feuille de fond style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. Chaque image coûte environ 0,7 à 1,5 k tokens, donc n'ouvrez que ce dont l'étape a besoin.
  • Pour la densité, $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md (« Statistiques de rythme » à la fin) : les scènes durent en moyenne 2,8 s, 2 à 4 événements visuels discrets par scène, un toutes les 0,4 à 0,8 s sur un mot accentué, une nouvelle page de légende environ toutes les 0,6 s. Copiez la densité, pas le contenu.

1. Rendu des images

Depuis le dossier video/ du projet :

$MOTION_LIB/core/tools/qa.sh NOM DE-À NTH [SCALE=0.3] [COLS=9]
  • Utilisez 4 à 6 timestamps par vérification. Pour une scène, NTH correspond approximativement à sa durée en images divisée par 4. Laissez DE-À vide pour l'ensemble du montage et augmentez NTH.
  • La sortie est out/qa/NOM_0.jpg (et _1, _2 pour des plages plus longues), avec au maximum 45 images par planche. Lisez la planche ; gardez les planches petites.
  • Une commande QA par scène, et jamais deux rendus simultanément. Limitez les corrections à deux rounds par scène.
  • Vérifiez par rapport au storyboard : l'image 0 de la scène, ses événements clés sur leurs mots, rien de coupé, rien ne recouvrant la bannière ou les bandes de légende.

2. Checklist

  • Chaque objet se lit comme du papier : grain, bord rugueux, ombre portée, ombrage en couches empilées, pas de contours ni de dégradés.
  • La caméra du monde bouge de manière fluide. Seules la bannière et les étiquettes tremblent (par paliers, subtilement).
  • La bannière est fixe en position et scotchée, 3 à 7 mots, un fait chacun, ne répète jamais la VO. Les bannières seules se lisent comme une fiche d'information.
  • Chaque décor illustre un mot concret de sa ligne VO, les nombres sont des accessoires physiques, et il y a un décor de rappel avant le CTA.
  • Chaque nombre et étiquette d'interface remonte à la liste des faits. Le script a au moins une limitation honnête et une pile de fonctionnalités de exactement trois.
  • Légendes : une étiquette par mot, inclinée, apparaissant en début de mot, pages de 1 à 3, dans la bande 68-80 %, jamais sur un visage.
  • Saturation uniquement sur les personnages, les légendes et les signaux.
  • Un événement visuel sur chaque mot accentué, avec un mouvement ambiant toujours actif.
  • Coupures lors des changements de bannière (décors 1,5 à 3 s dans les visites et actualités, jusqu'à 5 s dans un temps métaphorique), les 20 % du bas dégagés.
  • Le bloc HOOK (SAY / WRITE / SHOW / ALIGN) est à l'écran exactement comme écrit : l'image 0 montre le moment SHOW en pleine action avec le titre WRITE dessus, et la première ligne VO est SAY.
  • Chaque scène a un mouvement de caméra, au maximum un tournage de page ou une déchirure, un tirage de ruban adhésif ou un coup de fouet vers le CTA, et chaque transition a son effet sonore.
  • Passage humour visible à l'écran : un format tout au long, un accessoire de costume par idée, un temps de lutte, l'accessoire de l'image 0 revient modifié dans le décor CTA, et chaque gag se lit en moins de 1 s et ne recouvre jamais la bannière, les légendes ou le nombre clé.
  • Le vocabulaire dans la VO et les bannières correspond au niveau d'audience de SERIES.md.
  • La voix off, les légendes et les événements sont synchronisés (scrutez le Studio à chaque coupure).

Pour un élément en échec, corrigez le fichier de la scène (ou le kit dans la bibliothèque, jamais src/lib/ dans le projet) et relancez la scène. Reconstruisez une scène avec motion-build.

3. Livraison

Ouvrez l'aperçu Studio, listez les scènes avec leurs durées, et indiquez ce qui est un placeholder : voix, musique, effets sonores, assets. Si la voix est un placeholder, dites comment la remplacer (motion-voice). Après publication, les chiffres vont à motion-strategy pour l'autopsie.

Vérification des principes

Scrutez une scène à 5 images par seconde et vérifiez par rapport à $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md : anticipation avant chaque grand mouvement (2), tout est lissé (6), quelque chose traîne après les impacts (5), un accessoire focal (3), un temps exagéré (10), ombrage empilé et ombre cohérente (11).

Transfert

Les corrections retournent à motion-build (scène ou son) ou motion-voice (synchronisation). Un passage propre termine le montage : effectuez le rendu avec $MOTION_LIB/core/tools/render.sh lorsque l'utilisateur le demande.

Individual skills in this repo

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

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

Skills associés