Que fait Papercut Explainer ?
Un explicatif vertical d'environ 20 à 45 secondes qui donne l'impression de couches de papier de construction animées : accessoires en papier granuleux avec ombres portées, animation de découpage rigide, un lent mouvement de caméra avec un effet de « bouillonnement » du papier d'arrêt sur image, une bannière titre scotchée par temps fort et des légendes mot par mot en papier déchiré. Construit avec Remotion, des assets texturés générés optionnellement par IA, et n'importe quel TTS.
Chaque scène contient trois pistes :
- la voix off raconte l'histoire
- la bannière scotchée ajoute un fait concret que la voix off omet
- un décor en papier frais illustre les paroles de la voix off, avec une reconstruction approximative en papier découpé de l'interface produit qui fait la démo
Réutilisez le style et la narration, pas le contenu des exemples travaillés. Chaque produit, entreprise et chiffre dans les exemples est inventé. Les règles de style se trouvent dans $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md (la section 2 est l'ADN du style).
Prévol
- Bibliothèque. Résoudre
$MOTION_LIB, sinon la ligneMOTION_LIB=dans${XDG_CONFIG_HOME:-~/.config}/motion-explainer/config.env, sinon demander une fois. Ne jamais coder en dur un chemin de machine. Les étapes 1 à 4 n'ont pas besoin de la bibliothèque. - Mode d'installation. Le sonder avant de promettre une étape (voir Modes d'installation ci-dessous).
- Série. Trouver le dossier de la série (il contient
episodes/). Lire sonSERIES.mds'il existe.
Modes d'exécution (demander d'abord)
- Vidéo complète, de l'idée au MP4 : étapes 1 à 8, puis étape 9 après la publication.
- Script uniquement : stratégie, accroche, script (s'arrêter après le tableau de mise en scène).
- Storyboard à partir d'un script existant :
motion-storyboard. Demander le script, les faits et le bloc HOOK. - Prompt de style pour un autre outil : donner le bloc approprié de
$MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.mdet s'arrêter. - Corriger ou reconstruire une scène :
motion-build(étape des scènes), puismotion-qa.
Collecte des informations (ne demander que ce qui manque)
- Source : généralement un lien (dépôt, site produit, annonce). Tout le reste est recherché à partir de celle-ci.
- L'affirmation unique que la vidéo prouve, et le sujet.
- Cadre des rôles : qui ou quoi fait le travail, qui conseille ou approuve. Le confirmer avec l'utilisateur et ne jamais inventer de comportement produit.
- Mot-clé CTA et ce que le spectateur obtient (le livrable).
- Durée : par défaut 22-30 secondes.
- Niveau du public (depuis
SERIES.md) et éventuelle couleur d'accent ou mascotte.
Écrire les réponses sous forme du bloc BRIEF en haut de episodes/NN-slug/research/facts.md (format dans motion-strategy).
Étapes
| # | Étape | Compétence | Lit | Écrit |
|---|---|---|---|---|
| 1 | Stratégie | motion-strategy | SERIES.md, la source | BRIEF dans research/facts.md, SERIES.md |
| 2 | Accroche | motion-hook | BRIEF | Bloc HOOK en haut de video/STORYBOARD.md |
| 3 | Script | motion-script | BRIEF, HOOK | research/facts.md, narration/script.json, tableau de mise en scène dans STORYBOARD.md |
| 4 | Storyboard | motion-storyboard | script.json, STORYBOARD.md | Tableau Caméra/Coupe, blocs de scène, plan SFX dans STORYBOARD.md |
| 5 | Échafaudage et planification | motion-build | STORYBOARD.md | le projet, episode.json |
| 6 | Voix et synchronisation | motion-voice | script.json, voice/voice.json | Prises narration/, public/vo/captions.json, src/plan.json |
| 7 | Scènes, son, rendu | motion-build | plan.json, STORYBOARD.md | src/scenes/*, tools/cues.json, out/*.mp4 |
| 8 | QA | motion-qa | images fixes, STORYBOARD.md | corrections, le résumé de livraison |
| 9 | Après publication | motion-strategy (autopsie), motion-build (récolte) | chiffres de la plateforme, le projet | research/analytics/, promotions de la bibliothèque |
Fichiers du projet
Le pipeline vit dans des fichiers, pas dans le chat. Chaque étape lit les fichiers ci-dessus et écrit les siens, de sorte qu'une nouvelle session peut reprendre à n'importe quelle étape.
<series>/
SERIES.md optionnel : public, voix, palette, mascotte, journal des mots-clés
voice/voice.json optionnel : réglages vocaux (copier library/voice/voice.example.json)
video-assets/ optionnel : textures et accessoires de superposition
research/analytics/ optionnel : études concurrentielles et autopsies
episodes/NN-slug/
research/facts.md BRIEF + faits avec sources
narration/script.json [{"id": "l1_hook", "text": "..."}, ...]
video/
episode.json scènes, bannières, accroche, écarts, fond sonore, coupes
STORYBOARD.md HOOK, tableau de mise en scène, tableau Caméra/Coupe, blocs de scène
Catalogues de la bibliothèque : style/$MOTION_STYLE/remotion/CATALOG.md (chaque composant de kit) et $MOTION_LIB/core/audio/CATALOG.md (chaque SFX et fond sonore). Ils sont générés, donc une nouvelle extraction peut les manquer ou en avoir d'obsolètes. Exécuter python3 $MOTION_LIB/core/tools/catalog.py pour les reconstruire. Les agents lisent les catalogues, pas le code source du kit.
Réutiliser avant d'écrire : un composant de kit, un ensemble d'accessoires ou un modèle de scène est préférable à un nouveau code de dessin. Choisir les SFX et fonds sonores par leur nom.
Modes d'installation
- Minimal (compétences seulement) : stratégie, accroche, script, storyboard, prompts de style. Pas de rendu.
- Standard : Minimal + construction et rendu avec une voix de synthèse (silencieuse, ou
sayde macOS) via$MOTION_LIB/core/tools/placeholder_vo.py, QA sur images fixes, audio SFX et fond sonore, le MP4 complet. - Complet : Standard + voix off locale Qwen3-TTS et sous-titres synchronisés à partir de l'audio réel.
Sonder (lecture seule) :
. "$(grep '^MOTION_LIB=' "${XDG_CONFIG_HOME:-$HOME/.config}/motion-explainer/config.env" | cut -d= -f2-)/env.sh" # remplit MOTION_PY, QWEN_TTS_PY
node -v; ffmpeg -version | head -1
"$MOTION_PY" -c 'import numpy, PIL, soundfile'
"$QWEN_TTS_PY" -c 'import qwen_tts'
Les trois premières lignes qui réussissent signifient Standard. L'import qwen_tts qui réussit également signifie Complet. Si une étape nécessite plus que ce que l'installation fournit, le dire en une ligne, exécuter ./install.sh --doctor depuis la racine du dépôt, et passer la main à motion-setup au lieu d'improviser. Trouver la racine avec readlink sur le dossier de compétence installé (sous .claude/skills, .agents/skills, .config/opencode/skills ou un autre dossier de compétences d'un harnais), ou MOTION_HOME dans le fichier de configuration.
Règles communes aux étapes
- Les notes de stratégie l'emportent sur les notes de style : 22-30 secondes, et pas d'accroches formatées comme des actualités.
- Paralléliser le travail indépendant (groupes de scènes, arrière-plans et accessoires, re-rendus) avec des agents en une seule fois.
- Rendre uniquement sur demande. Prévisualiser dans le Studio Remotion.
Références partagées
$MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md: ADN du style, dessin en papier découpé, palette, polices, texture, caméra et tremblement, synchronisation des mouvements, légendes, son.$MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md: prompts portables pour d'autres agents et générateurs.$MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: les 12 principes de l'animation mappés aux composants et aux aides du kit, avec une note d'utilisation à chaque étape.$MOTION_LIB/style/$MOTION_STYLE/remotion/RECIPES.md: esquisses de composants Remotion, pour quand il n'y a pas de bibliothèque.$MOTION_LIB/style/$MOTION_STYLE/docs/asset-prompts.md: quoi générer par rapport à quoi construire en code, avec des modèles de prompts.$MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md: un exemple travaillé d'environ 28 secondes à une résolution de 0,2 seconde. Copier sa densité d'événements, pas son contenu.
Passage de relais
Commencer à l'étape 1 pour une vidéo complète, ou à l'étape nommée par le mode d'exécution. Après la collecte des informations, exécuter motion-strategy ; il lit SERIES.md et le BRIEF et passe la main à motion-hook. Chaque compétence d'étape nomme la suivante.