/stick-figure
┌──────────────────────┐
│ ☀ ☁ │ ciel lumineux, mer, accessoires dessinés en code
│ ◯ ◯ │ bonhommes allumettes à grosse tête blanche, expressions expressives
│ /|\ /|\ │
│ / \ / \ 🛢 │
│ cache-œil │ légendes de 1 à 2 mots, minuscules, ~70% en bas
└──────────────────────┘
Un exemple complet est fourni : engine/template est un reel de 37 s terminé, intitulé « Que faire si les cache-œil des pirates n'avaient rien à voir avec des yeux manquants ? »
Première utilisation
Le dossier de ce skill est le « Répertoire de base » que Claude Code affiche lors de son chargement.
SKILL_DIR="<répertoire de base de ce skill>"
ENGINE="$SKILL_DIR/engine"
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
[ -x "$KIT/.venv/bin/python" ] && [ -d "$KIT/models" ] || bash "$KIT/setup.sh" --voice # ~1 Go de modèles vocaux, une fois
PY="$KIT/.venv/bin/python"; export NODE_PATH="$KIT/node_modules"
Nécessite ffmpeg, Node et Python 3.9+. Pour voir l'exemple : cp -r "$ENGINE/template" ~/reels/pirate && bash "$ENGINE/make.sh" ~/reels/pirate.
Comment tout s'assemble
Un reel est un dossier unique :
script.json: la voix-off, une phrase par entrée.captions.json: remplacements de texte facultatifs pour les légendes ({"vingt cinq": "25"}).web/shots.js: la liste des plans. Chaque plan estSHOTS.push({start, end, tr, draw(ctx, lt, t)})en secondes de la voix-off ;ltest le temps à l'intérieur du plan,trest la transition de sortie ('whip'ou'cut').web/lib.js(easing, keyframeskf, formes, texte),web/chars.js(le rig du bonhommedrawStick, chapeaux, visages, IK des bras, le cache-œil),web/env.js(ciel, nuages, mer, navires, pont, barils, canon, lanterne, sous-pont),web/main.js(flou de transition, vignette, grain, légendes). Ajoutez de nouveaux accessoires dansenv.jsou un nouveauenv2.js(listez-le dansweb/index.html).audio.py: musique et bruitages, tous synthétisés en code et placés en secondes de la voix-off.
make.sh génère la voix, aligne chaque mot (audio/words_new.json), mixe le son, rend les plans en parallèle et écrit <dossier>/<nom du dossier>.mp4.
Timing : audio/words_ref.json est la voix sur laquelle les plans ont été calés. Quand la voix change mais que les mots restent les mêmes, make.sh ajuste les plans sur la nouvelle prise, donc un nouvel enregistrement ne nécessite aucune modification. Si le script change, supprimez audio/words_ref.json (la prise suivante devient la référence) et re-calez shots.js.
Étapes
- Script. Environ 110 à 120 mots pour 38 à 40 secondes, une idée par phrase : un accroche « que faire si », la croyance commune, un retournement avec « Mais », des exemples qui s'enchaînent, un plan qui montre le mécanisme, et une conclusion qui répond à l'accroche. Montrez-le à l'utilisateur avant d'animer.
- Faits. Vérifiez chaque affirmation avec des sources. Tempérez les théories (« les scientifiques pensent »).
- Dossier.
cp -r "$ENGINE/template" <reel>, puis videz sonaudio/et remplacezscript.json(etcaptions.json). - Voix. Dans le dossier :
"$PY" "$ENGINE/tools/tts_kokoro.py"(gratuit) ou un enregistrement personnel de l'utilisateur, ou ElevenLabs avecELEVENLABS_API_KEY("$PY" "$ENGINE/tools/tts_elevenlabs.py" audio/vo_el.mp3). Placez la prise dansaudio/vo.wav, puis"$PY" "$ENGINE/tools/align.py" audio/vo.wavet lisez les temps des mots dansaudio/words_new.json. - Plans. Réécrivez
web/shots.js: environ 10 à 12 configurations, la plupart de 2 à 4 s, le plan explicatif plus long. Une nouvelle idée nécessite une nouvelle configuration. Commencez l'accroche en action dès l'image 1. Gardez les visages et les accessoires clés hors de la bande des légendes (y environ 1250 à 1420) et dans la zone de sécurité d'Instagram (x 100 à 980, y 220 à 1500). - Images fixes. Depuis le dossier :
node "$ENGINE/tools/render.js" stills 1.5,4.2,9.0écrit dansstills/. Examinez les moments les plus chargés et corrigez-les avant un rendu complet. - Son. Modifiez les repères dans
audio.pyen fonction des temps des mots. - Construction.
bash "$ENGINE/make.sh" <reel>(conserveaudio/vo.wav; passezkokoro,elevenlabsou un fichier pour le remplacer).WORKERS=8sur une machine avec plus de cœurs.AUDIO_ONLY=1remixe le son sans re-rendu. - Livrez
<reel>/<nom>.mp4.
Style
- Légendes : Poppins Bold, blanc avec un contour foncé, 1 à 2 mots, minuscules, sans ponctuation (
capText()dansmain.jss'en charge ; les chiffres et%restent). Pas de tirets cadratins à l'écran. - Palette : saturée lumineuse, contours à l'encre (
#221c22), ombres portées douces, avancées lentes avec dérive de prise en main, transitions whip avec flou de mouvement. Un impact est une explosion, une secousse et un flash. - Bruitages : placés sous la voix (gain environ 0.38). La musique est un underscore discret pincé, atténué sous la voix, jamais une boucle forte au début.