Communitygithub.com

motion-craft

Crée des vidéos animées explicatives et des Shorts cinématographiques basés sur du code (9:16 Shorts & 16:9 Vidéo, durée de 15 secondes à 10 minutes) dans 16 catégories visuelles de qualité studio : 3D, Isométrique, Vue éclatée de maison, Stickman 3D, Astronomie (GLSL Trous noirs), Monde animal, Océan 3D, Science & Nature, Histoire, Cartes (Natural Earth d3-geo), Islamique, Géographie, Anatomie, Contes folkloriques, Dessin animé et Animation 2D. Génère des recommandations visuelles, un script par étapes (Hook -> Scène 1..N), un fichier HTML autonome directement lisible dans un navigateur, un package de code source ZIP, et un rendu vidéo MP4 déterministe. Utilisez cette compétence chaque fois qu'un utilisateur demande une vidéo animée, un Short éducatif, une explication, une simulation 3D, une carte historique/géographique, un stickman 3D, une anatomie ou un storyboard vidéo.

Qu'est-ce que motion-craft ?

MotionCraft est une compétence universelle pour agent IA (compatible avec Claude Code, Cursor, Codex, etc.) qui permet de générer automatiquement des vidéos animées explicatives et des Shorts de haute qualité (15 secondes à 10 minutes) dans 16 catégories visuelles distinctes, allant de la 3D, à l'isométrique, la vue éclatée, l'astronomie, les animaux, l'océan, la science, l'histoire, la cartographie, les scènes islamiques, la géographie, l'anatomie, les contes folkloriques, les dessins animés et l'animation 2D. Cette compétence transforme une simple phrase décrivant une idée en un projet complet : elle recommande un style visuel spécifique, crée un script narratif détaillé avec un accroche (HOOK) et des scènes successives, puis génère un fichier HTML autonome qui s'exécute directement dans un navigateur, sans dépendance à des bibliothèques Node.js autres que les scripts internes de build. Le résultat inclut également une archive ZIP du code source et, si un navigateur headless est disponible, un rendu vidéo MP4 déterministe et reproductible. La compétence utilise un moteur d'animation JavaScript dédié (bibliothèque MF) et applique des règles strictes de qualité (interdiction des formes primitives sans texture, utilisation de variables responsive pour 9:16 et 16:9, code déterministe sans Math.random()) pour garantir un rendu professionnel et cohérent, équivalent à des exemples de référence fournis dans la documentation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

Demander à votre IA préférée

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

Documentation

MotionCraft — Compétence Universelle pour Agent pour Vidéos Explicatives & Shorts en 16 Catégories

Compétence autonome (zero dépendance applicative) qui transforme 1 phrase d'idée d'histoire en recommandation d'orientation visuelle, script par étapes (HOOK → SCÈNE 1 → SCÈNE 2 → etc. jusqu'à 10 minutes), fichier autonome <slug>.html (double-clic, s'exécute directement dans le navigateur avec bouton de changement de rapport 9:16 ↔ 16:9 & effets sonores WebAudio), package de code source <slug>-source.zip, ainsi qu'un rendu vidéo .mp4.


Flux de Travail Obligatoire (5 Étapes)

Étape 1 — Recommandation Visuelle & Plan de Script (HOOK → SCÈNE 1..N)

Quand l'utilisateur donne une idée d'histoire (si le rapport ou la durée ne sont pas précisés, utiliser par défaut 9:16 Shorts 30–45 s pour des faits brefs, ou 16:9 Vidéo 60–600 s pour un sujet approfondi) :

  1. Choisir 1 Catégorie la plus adaptée parmi les 16 Catégories Officielles : 3D · Isométrique · Vue éclatée de maison · Stickman 3D · Astronomie · Monde animal · Océan · Science & Nature · Histoire · Cartes · Islamique · Géographie · Anatomie · Contes folkloriques · Dessin animé · Animation 2D.
  2. Formuler une Recommandation Visuelle Spécifique :
    • Objets & Accessoires (objets) : sujet principal texturé/articulé + au moins 3 accessoires de comparaison d'échelle/preuve.
    • Caméra & Transitions (camera) : motif multi-plans (large → gros plan détail → orbite / whipTo / pull-back).
    • Ambiance & Éclairage (ambiance) : atmosphère de ciel/espace, brouillard/lumière volumétrique, palette de couleurs, et ton narratif.
  3. Composer le Script par Étapes (0 à DUR secondes sans intervalle vide) :
    • La première partie OBLIGATOIRE est HOOK (3–10 secondes d'ouverture pour susciter la curiosité).
    • Suivent SCÈNE 1, SCÈNE 2, etc., et se termine par une conclusion factuelle solide (~2,2 mots/seconde).
    • Pour les durées longues (> 60 s jusqu'à 600 s / 10 minutes), lire Guide de Durée Longue 10 Minutes.

Étape 2 — Lire la Recette de Catégorie & le Standard d'Excellence du Code Exemple (OBLIGATOIRE !)

N'ÉCRIVEZ PAS sceneCode à partir d'une supposition vide ! Avant d'écrire du code d'animation :

  1. Lire le tableau des catégories et l'ID de style dans Catalogue des 16 Catégories ainsi que la liste des fonctions runtime dans Référence API Moteur v4 (MF).
  2. Lire les exemples de code source officiels les plus proches dans Standard d'Excellence du Code de Référence.
  3. Loi d'Équivalence de Qualité : La densité des objets, le détail des textures (CanvasTexture / SVG multicouche / lignes de côte world-atlas / shader GLSL), l'éclairage, et la fluidité de la caméra DOIVENT ÊTRE ÉQUIVALENTS aux exemples de golden-showcases.md. Il est interdit de dessiner des carrés/cercles simples sans texture ou sans accessoire !

Étape 3 — Règles d'Or pour l'Écriture de sceneCode

sceneCode est exécuté comme le corps de la fonction (MF, stage, tl, W, H, DUR) :

  • Double Responsivité (9:16 Shorts & 16:9 Vidéo) : Toujours utiliser les proportions W et H (W * 0.5, H * 0.45, size: W < H ? 50 : 56, labelX: W < H ? W * 0.08 : W * 0.54) pour que l'animation s'affiche entièrement sans être coupée en 1080×1920 ni en 1920×1080.
  • Ne pas Surcharger la Variable H : Ne jamais écrire const { H } = MF; car cela surchargerait la hauteur de la scène H ! Toujours appeler via le préfixe MF. (MF.H, MF.S, MF.T).
  • Déterministe à 100% : Interdiction d'utiliser Math.random(), Date.now(), setTimeout, ou setInterval. Utiliser MF.rng('seed-fixe'), des interpolations sur tl, et MF.onTick((t) => ...) comme fonction pure du temps t.
  • Frame 0 Directement Actif : Les éléments de la scène et le titre d'ouverture HOOK doivent utiliser at: 0 pour que la première image ne soit pas vide/sombre.
  • Anti-PPT : Maximum 1 titre d'accroche (MF.highlightHeadline) + 1 callout/chiffre (MF.leaderCallout / MF.bigStat) à la fois. L'histoire doit être portée par les changements d'action du monde/objets et les mouvements de caméra, pas par une suite de cartes de texte !

Étape 4 — Assembler le Fichier Autonome (.html, -source.zip, -script.md)

Créer un fichier de spécifications JSON (ex. spec.json) :

{
  "title": "Titre de la Vidéo",
  "idea": "Idée originale de l'histoire de l'utilisateur",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objets": "...",
    "camera": "...",
    "ambiance": "..."
  },
  "scenes": [
    { "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
    { "label": "SCÈNE 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}

Puis exécuter le script de construction autonome (pur Node.js intégré, 0 dépendance npm !) :

node "<chemin-vers-la-competence>/scripts/build.mjs" --spec chemin/vers/spec.json --out-dir chemin/destination

Ce script valide la syntaxe et le déterminisme du sceneCode, intègre ./assets/motion-engine.js, ./assets/sfx-synth.mjs, ainsi que ./assets/land-110m.json (si utilisation de cartes), puis produit :

  1. <slug>.html — 1 fichier autonome prêt à être visionné dans n'importe quel navigateur (auto-loop + barre de défilement + bouton de changement de rapport 9:16 ↔ 16:9 + effets sonores WebAudio).
  2. <slug>-source.zip — archive complète du code source (index.html, src/scene.js, src/project.json, SCRIPT-ET-STORYBOARD.md, engine/).
  3. <slug>-script.md — document du script et recommandation visuelle bien présentée.

Solution de Rechange Sans Shell / Web Chat : Si l'environnement de l'agent n'a pas accès à un terminal Node.js, copier le contenu de ./assets/starter-template.html, remplacer les placeholders /*__MOTION_ENGINE__*/, /*__SFX_SYNTH__*/, et /*__PROJECT_JSON__*/ null directement pour produire le fichier index.html complet.

Étape 5 — Vérification des Images & Export Vidéo MP4 (Optionnel / Si Navigateur Headless Disponible)

Si l'environnement dispose de Chrome/Edge + puppeteer-core (ou puppeteer), exécuter une vérification automatique pour s'assurer 0 erreur d'exécution et vérifier les captures d'écran :

# Vérification rapide (vérifier 0 erreur + sauvegarder la capture d'écran HOOK & intermédiaire) :
node "<chemin-vers-la-competence>/scripts/export-mp4.mjs" --html chemin/destination/<slug>.html --verify-only

# Rendu complet en vidéo MP4 (H.264 + AAC SFX automatique, optionnel + --vo narration.mp3) :
node "<chemin-vers-la-competence>/scripts/export-mp4.mjs" --html chemin/destination/<slug>.html --fps 30 --scale 1

Si des erreurs ou des textes superposés sont détectés sur les captures de vérification, corriger sceneCode, reconstruire avec scripts/build.mjs, puis soumettre le résultat à l'utilisateur.

Skills associés