Communitygithub.com

datassthou64-source/blue-motion-kit

Transformez l'audio de voix off d'un créateur en graphiques animés HyperFrames visuels et documentés. À utiliser lorsqu'on vous fournit un ou plusieurs fichiers audio pour une vidéo de créateur et qu'on vous demande de transcrire, analyser, rechercher les concepts ou produits en ligne, construire ou réviser des graphiques animés purs, prévisualiser localement ou rendre dans le style dégradé bleu continu établi.

Qu'est-ce que blue-motion-kit ?

Blue Motion graphics est un kit de compétences pour agents IA (comme Claude Code) qui transforme des fichiers audio de voix off en séquences de graphiques animés (motion graphics) de style visuel pur, en privilégiant des objets réels, des logos officiels et des captures d'interface plutôt que du texte abstrait. L'agent doit d'abord charger le skill `/motion-visual-sourcing` qui établit les deux lois fondamentales : "visuel d'abord, texte ensuite" (supprimer chaque mot, l'idée doit rester compréhensible) et "chaque entité nommée mérite un actif réel sourcé" (chercher le vrai logo, l'interface réelle ou une capture de site pour toute entreprise, produit, site ou dépôt nommé dans la voix off). Le kit fournit une bibliothèque complète de modèles de scènes, de motifs, d'actifs (logos vérifiés) et de scripts pour la création de projets, la transcription avec repères temporels, la recherche de concepts, le storyboard, le rendu local et l'export vidéo au format 1920×1080 30 fps SDR BT.709. Le workflow structuré en 15 étapes couvre toute la chaîne : écoute de l'audio, transcription, analyse en battements sémantiques, recherche de marques, storyboard, adaptation des modèles visuels, vérification (check des géométries et inspection visuelle de chaque scène), et rendu final avec un script qui génère les fichiers MP4 et un fichier XML d'import pour Premiere/DaVinci Resolve. Le kit insiste sur la vitesse et la discipline des tokens, la réutilisation des actifs vérifiés, et le respect strict des règles de style et d'honnêteté visuelle (pas de visages, pas de légendes, max 3 mots par étiquette, rien de fabriqué).

Compatible avec✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/datassthou64-source/blue-motion-kit/tree/HEAD/.claude/skills/blue-motion

Demander à votre IA préférée

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

Documentation

Graphiques animés Blue Motion

Créez une explication visuelle factuelle autour de la voix off. Privilégiez les objets reconnaissables, le langage UI des produits, les logos officiels et les transformations plutôt que les légendes ou les cartes de texte abstraites.

Chargez /motion-visual-sourcing en premier. Il possède les deux lois dont ce style dépend — visuel d'abord, texte ensuite (supprimez chaque mot ; l'idée doit encore être comprise) et chaque entité nommée mérite un actif réel et sourcé (récupérez le vrai logo, la vraie interface ou une capture de site pour toute entreprise, produit, site ou dépôt que la voix off nomme — jamais une boîte générique ou le nom en texte brut). Ce skill du dégradé bleu gouverne l'apparence ; ces lois gouvernent ce qui est affiché à l'écran.

Où tout se trouve

Tous les chemins ci-dessous sont relatifs à KIT, la racine du dépôt blue-motion-kit. bash <dossier de ce skill>/scripts/kit-root.sh l'affiche (il résout les liens symboliques, donc il est correct que ce skill ait été chargé depuis le dépôt ou via un lien).

CheminQuoi
library/design.mdLe seul cahier des charges visuel — palette, typographie, objets, verbes de mouvement, règles d'honnêteté et la carte argument → scène. Remporte tout conflit. Lisez-le avant de storyboarder.
library/scenes/13 modèles pilotés par configuration issus de la construction approuvée de Grok Bot. Copiez le .html + .motion.json dans compositions/ et modifiez le bloc CFG en haut de sa <script> ; la géométrie se régénère à partir de cela.
library/patterns/Les primitives statiques antérieures. Toujours valides.
library/PATTERNS.mdIndex des deux.
library/assets/logos/Marques officielles figées et vérifiées (Grok, Grok Bot, xAI, X, Cursor, Claude, Slack, Instantly, HeyReach, HubSpot, GitHub…). SOURCES.md est la table de provenance. Vérifiez ici avant de récupérer.
reference/grok-bot/La construction de référence approuvée : sources de scènes, planches contact et deux rendus finis. Regardez, ne copiez pas en bloc.
brand/creator.mdQui regarde et comment le créateur parle.
KIT/editor.local.mdLes préférences de l'éditeur sur cette machine issues de l'entretien de première exécution (dossier de projets, NLE, paliers d'approbation). Lisez-le s'il existe.
references/build-recipe.md (ce skill)Le contrat de composition et les bugs qui passent check proprement. Lisez lors de la création ou du débogage.
references/scene-patterns.md (ce skill)Appareils fabriqués à la main qui ne sont pas des modèles.
scripts/ (ce skill)bootstrap-project.sh (nouveau projet), render_passages.py (export), hlg_to_sdr.py (correction des séquences HDR), fetch-logo.py (résolveur de logo), kit-root.sh.

Un modèle fournit la chorégraphie, l'assouplissement, la palette et la sécurité temporelle. Il ne fournit rien sur le fait qu'il soit la bonne idée pour ce moment. Changez le texte et la métaphore pour correspondre à ce qui est réellement dit ; recherchez à nouveau chaque produit nouvellement nommé et utilisez ses actifs officiels actuels. Ne livrez jamais le texte de substitution d'un modèle.

Workflow

  1. Lisez brand/creator.md et editor.local.md s'il est présent.

  2. Utilisez les compétences obligatoires HyperFrames, motion-graphics, media-use et CLI.

  3. Inspectez uniquement l'audio fourni. Ignorez les travaux antérieurs pour cet audio, sauf si l'éditeur demande explicitement de les réutiliser.

  4. Échafaudez le projet : bash SKILL_DIR/scripts/bootstrap-project.sh PROJECTS_DIR/<video-slug> AUDIO... (PROJECTS_DIR provient de editor.local.md ; par défaut KIT/projects). Il copie le starter, le dégradé, les logos et les deux générations de modèles, et imprime la durée de chaque fichier audio.

  5. Transcrivez chaque fichier avec des repères temporels de mots (npx hyperframes transcribe assets/audio-01.<ext> --dir . ou le chemin media-use actuel). Lisez-le pour vérifier la cohérence et corrigez les erreurs évidentes de noms propres (Clay, n8n, Instantly, HeyReach, Prospeo, Apify, Grok, Cursor, Claude Code, Codex, MCP).

  6. Pour plusieurs fichiers, conservez les originaux et placez-les séquentiellement sur une seule timeline. Utilisez ffprobe pour des décalages exacts.

  7. Transformez la transcription en battements sémantiques : plage temporelle, signification, sujet visuel, action et besoin de recherche.

  8. Recherchez les concepts inconnus et l'image de marque actuelle des produits avant de dessiner. Privilégiez les sources officielles, sauvegardez les actifs résolus localement et enregistrez les sources dans RESEARCH.md. Logos : python3 SKILL_DIR/scripts/fetch-logo.py --manifest logos.txt assets/logos, puis ouvrez chaque fichier qu'il retourne.

  9. Storyboardez l'audio complet avant de créer (STORYBOARD.md). Visez une scène visuelle complète toutes les 4 à 8 secondes. Si editor.local.md demande une validation du storyboard, arrêtez-vous ici et montrez-le.

  10. Placez la vidéo en dégradé bleu dans la timeline parent, un clip ininterrompu par passage de graphiques animés, et gardez chaque scène transparente pour que l'arrière-plan ne se réinitialise jamais aux coupes.

  11. Adaptez le plus petit motif sémantiquement correspondant. Ne forcez pas un sujet dans un modèle simplement parce qu'il existe.

  12. Exécutez npx hyperframes check, puis faites un instantané de la trame de rendu de chaque scène et regardez les images. Les bugs de géométrie — un objet atterrissant aux mauvaises coordonnées, un élément glissant sur un autre — passent check silencieusement et n'apparaissent que dans une trame.

  13. Ouvrez l'aperçu local (npm run dev) et donnez l'URL à l'éditeur. Ne lancez pas le rendu tant que l'éditeur n'a pas explicitement approuvé (sauf si editor.local.md spécifie un rendu automatique).

  14. Après approbation, exportez avec le script par défaut. N'exécutez pas un rendu de timeline complète.

    python3 SKILL_DIR/scripts/render_passages.py PROJECT_DIR
    

    Il rend chaque passage de graphiques animés dans renders/MGNN-<label>.mp4. Il convertit d'abord toute séquence HLG en SDR, et il vérifie chaque fichier pour 1920×1080, 30 ips, nombre de trames, audio et SDR BT.709. Il écrit ensuite premiere-cuts.xml, qui place chaque fichier à sa position réelle sur la timeline VO (importable dans Premiere et DaVinci Resolve). Utilisez --dry-run pour lister les passages, --only 3,8 pour ne refaire le rendu que de certains, et --xml-only pour reconstruire le XML. Ensuite, regardez une trame de chaque fichier ; les vérifications du script ne peuvent pas voir un calque manquant. Détails et raisons : references/build-recipe.md §7.

  15. Terminez par un court transfert : chemin du projet, les rendus, le XML et tous les actifs que vous n'avez pas pu vérifier.

SKILL_DIR est le dossier de ce skill : KIT/.claude/skills/blue-motion.

Vitesse et discipline des tokens

  • Réutilisez exactement le dégradé, les tokens de style et les primitives de scène vérifiées.
  • Recherchez uniquement les noms qui affectent les visuels factuels : produits, logos, interfaces, flux de travail ou objets physiques.
  • Privilégiez une source faisant autorité pour un fait simple ; ajoutez-en plus uniquement en cas d'ambiguïté.
  • Gardez BRIEF.md, RESEARCH.md et STORYBOARD.md compacts.
  • Réutilisez la géométrie précise pour les ordinateurs portables, les fenêtres de dépôt, les tuiles d'applications et les routes.
  • Montrez des instantanés ou l'aperçu local plutôt que de narrer les choix CSS.

Non-négociables

L'apparence et les règles d'honnêteté sont dans library/design.md §9–10 : pas de caméra faciale, pas de légendes ou de cartes de phrases, des étiquettes de 1 à 3 mots, des marques réelles sourcées sur les plaques, et rien de fabriqué. En plus de celles-ci :

  • Les écrans d'ordinateurs portables restent proches du 16:9 et les appareils positionnés ne pulsent jamais ni ne changent de dimensions.
  • Les objets en mouvement se déplacent en continu. Ne vous arrêtez pas à mi-chemin, sauf si la narration décrit un arrêt. Utilisez un mouvement de va-et-vient fluide pour les idées d'aller-retour.
  • Faites de chaque scène une idée visuelle dominante avec un changement d'état clair, en utilisant un verbe tangible : diviser, copier, synchroniser, extraire, pousser, chercher, assembler, acheminer, déverrouiller, comparer, transformer.

Modifier le kit lui-même

Une nouvelle règle durable (un appel de style, un actif par défaut, un nouveau piège) va dans son seul foyer — l'apparence dans library/design.md, piège/procédure dans ce skill, faits sur le créateur dans brand/creator.md — jamais dans les notes d'un projet ou la mémoire de l'agent. Ensuite, validez-la pour que chaque éditeur l'obtienne (voir CONTRIBUTING.md à la racine du kit).

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés