Communitygithub.com

code-motion-director

Génère des présentations animées de code, des vidéos explicatives et des séquences d'exécution de terminal pour créateurs, formateurs et développeurs. Utilisez-le lorsque l'utilisateur exécute /code-motion ou demande d'animer du code, de créer une vidéo de codage ou de visualiser l'exécution de code.

Qu'est-ce que code-motion-director ?

Ce skill permet de créer des animations détaillées de code pas à pas, idéales pour des présentations, des tutoriels, des vidéos pour réseaux sociaux (TikTok, YouTube Shorts, Instagram Reels) ou des démonstrations techniques. Il transforme un extrait de code statique en une vidéo ou une page HTML interactive avec une machine à écrire progressive, des lignes de focus en surbrillance, des notes explicatives et un terminal animé. Le skill fonctionne de manière autonome (sans clé API externe ni services cloud payants) en utilisant un canvas HTML5/SVG local, avec la possibilité d'exporter au format MP4 via Playwright, Puppeteer ou ffmpeg. Il est compatible avec plusieurs plateformes d'IA (Claude, ChatGPT, Gemini) et accepte une spécification JSON complète pour contrôler l'apparence, le rythme et le contenu de l'animation.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/ishtiyaq8811/code-motion-director/tree/HEAD

Demander à votre IA préférée

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

Documentation

/code-motion-director

┌──────────────────────────────────────┐
│ 🔴 🟡 🟢  src/auth/session.ts   [9:16]│  barre de titre macOS avec chemin de fichier
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02   const decoded = await verify(); │  ligne active en focus
│ 03   if (!decoded.valid) {     ┌─────┼─ 01 Validation du jeton
│ 04     throw new AuthError();  │     │
│ 05   }                               │  lignes inactives atténuées
│ 06   return decoded.user;            │
├──────────────────────────────────────┤
│ > EXÉCUTION DU TERMINAL              │  tiroir terminal coulissant
│ > POST /api/v1/auth/verify HTTP/1.1  │  journalisation animée stdout
│ > Statut : 200 OK (14.2 ms)           │
└──────────────────────────────────────┘

Première utilisation

Le répertoire de cette compétence est le répertoire de base du paquet de compétences.

# Vérifier que Python 3 est installé
python3 --version || python --version

Fonctionne de manière autonome sans clés API externes, dépendances lourdes ou API cloud payantes. Utilise un Canvas HTML5 / SVG sans tête avec Playwright, Puppeteer ou ffmpeg en option pour le rendu MP4 sans tête.


Étapes d'exécution de l'agent

  1. Code & Storyboard : Demandez à l'utilisateur l'extrait de code ou extrayez-le de sa requête. Identifiez le récit principal :
    • Quel langage ? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS).
    • Quel est le point central ? (par exemple, un appel async/await, un décorateur, une levée d'erreur, un retour récursif).
    • Quelle sortie terminal ou quel résultat d'exécution prouve son fonctionnement ?
  2. Création de la spécification : Écrivez <nom>.code.json (spécification détaillée ci-dessous) dans le répertoire de travail.
  3. Construction et rendu : Exécutez le script de construction :
    python build.py <nom>.code.json
    
    • Pour une lecture interactive immédiate en HTML, ouvrez le fichier <nom>.motion.html généré.
    • Pour inspecter une image fixe d'une frame : python build.py <nom>.code.json --snap 4.5.
    • Pour valider la syntaxe du schéma : python build.py <nom>.code.json --validate.
  4. Vérification de la qualité :
    • Les lignes de code tiennent confortablement sans débordement horizontal (48 caractères max par ligne recommandé pour le 9:16 mobile ; 80 max pour le 16:9).
    • Les annotations sont concises, numérotées de 01 à 03 et pointent clairement vers les lignes cibles.
    • La sortie terminal reflète avec précision un comportement d'exécution réaliste.
  5. Remise : Livrez le chemin du fichier HTML / vidéo rendu et le résumé de la spécification à l'utilisateur.

Format de spécification (<nom>.code.json)

{
  "title": "src/auth/session.ts",
  "language": "typescript",
  "aspectRatio": "9:16",
  "theme": "obsidian",
  "code": [
    "async function verifyToken(token: string) {",
    "  const session = await auth.verify(token);",
    "  if (!session.isValid) {",
    "    throw new UnauthorizedError('Expired');",
    "  }",
    "  return session.user;",
    "}"
  ],
  "focusLines": [2, 3],
  "typingSpeed": 35,
  "callouts": [
    {
      "line": 2,
      "label": "Vérification asynchrone",
      "note": "Attend la signature cryptographique",
      "side": "right"
    },
    {
      "line": 4,
      "label": "Clause de garde",
      "note": "Rejette les charges JWT expirées",
      "side": "right"
    }
  ],
  "terminal": {
    "enabled": true,
    "title": "Sortie serveur (Node.js v22)",
    "commands": [
      "$ curl -X POST https://api.dev/auth/verify",
      "> Vérification de la signature HMAC-SHA256...",
      "> Jeton vérifié : user_id=4092 [200 OK]"
    ]
  },
  "sound": {
    "typewriterClicks": true,
    "completionChime": true
  },
  "durationSeconds": 8.0
}

Définitions des paramètres

  • title : Chaîne affichée dans la barre d'en-tête de la fenêtre (par exemple, nom de fichier ou chemin de module).
  • language : "javascript", "typescript", "python", "rust", "go", "sql", "bash".
  • aspectRatio : "9:16" (Bande verticale pour TikTok/Shorts/Instagram) ou "16:9" (Grand écran horizontal).
  • theme : "obsidian" (violet foncé profond), "onedark" (inspiré d'Atom), "monokai" (classique contraste élevé) ou "cyberpunk" (cyan/magenta néon).
  • code : Tableau de chaînes, chacune représentant une ligne de code.
  • focusLines : Tableau de numéros de ligne basés sur 1 pour conserver une luminosité à 100 % tandis que les autres lignes sont atténuées.
  • callouts : Liste facultative d'annotations. 3 annotations max recommandées.
    • line : Numéro de ligne basé sur 1 pour ancrer le trait d'annotation.
    • label : Titre court en majuscules ou en gras (18 caractères max).
    • note : Sous-titre explicatif (28 caractères max).
  • terminal : Tiroir inférieur facultatif avec les commandes et réponses stdout.
  • sound : Paramètres de synthèse procédurale Web Audio API facultatifs (clics de frappe et carillon).
  • durationSeconds : Durée totale de l'animation (par défaut : 8,0 s).

Plateformes prises en charge

PlateformeMéthode d'intégration
Claude / Claude CodeChargé via SKILL.md dans ~/.claude/skills/code-motion-director/ ou l'espace de travail .claude-plugin/
Google AntigravityEnregistré sous .gemini/antigravity/skills/code-motion-director/
ChatGPT / GPT personnalisésConfiguré via des instructions personnalisées en utilisant adapters/chatgpt-instructions.md
Google GeminiInjecté via instruction système en utilisant adapters/antigravity-gemini.md

Standards de goût et d'esthétique

  • Hiérarchie visuelle claire : Gardez le code propre, formaté et lisible. Ne collez jamais de code minifié.
  • Annotations concises : Les notes d'annotation doivent être des faits techniques, pas du battage marketing (« Attend la promesse », pas « Super fonctionnalité ! »).
  • Contraste et lisibilité : Assurez-vous toujours que la police du code est suffisamment grande pour les écrans de smartphones mobiles (28 px minimum sur un canevas 1080x1920).
  • Rythme : La frappe doit sembler naturelle (25 à 40 ms par caractère). La sortie du terminal doit apparaître après la fin de la frappe du code.

Skills associés