Communitygithub.com

code-motion-director

Erzeugt animierte Syntax-Walkthroughs, Code-Erklärvideos und Terminal-Ausführungsreels für technische Kreative, Lehrende und Entwickler. Bietet progressiven Schreibmaschinen-Effekt, Fokuszeilen-Dimming, Leader-Callouts und animierte Terminal-Stdout-Ausgabe. Verwenden, wenn der Benutzer /code-motion ausführt oder darum bittet, Code zu animieren, ein Coding-Reel zu erstellen, einen Syntax-Walkthrough zu machen oder eine Code-Ausführung zu visualisieren.

Was ist code-motion-director?

Diese Fähigkeit (Skill) für KI-Agenten wie Claude Code, Cursor oder Gemini generiert animierte Code-Visualisierungen in Form von HTML- oder MP4-Dateien. Sie ist ideal für technische Inhaltsersteller, die Code-Erklärvideos für Plattformen wie TikTok, YouTube Shorts oder Instagram Reels produzieren möchten. Der Skill unterstützt verschiedene Programmiersprachen (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS), wählbare Farbschemata und Seitenverhältnisse (9:16 für vertikale Reels, 16:9 für horizontale Videos). Er zeichnet sich durch einen schreibmaschinenartigen Texteffekt, das Hervorheben von Fokuszeilen, optionale Callout-Beschriftungen und eine simulierte Terminalausgabe aus. Die Ausführung erfolgt in mehreren Schritten: Der Agent bespricht den Code mit dem Benutzer, erstellt eine JSON-Spezifikation, führt ein Python-Build-Skript aus und liefert die fertige Animation aus. Der Skill verwendet keine externen KI-APIs, sondern arbeitet mit HTML5 Canvas/SVG, optional Playwright/Puppeteer oder ffmpeg für die MP4-Rendering, und ist daher offline und ohne zusätzliche Kosten nutzbar.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

/code-motion-director

┌──────────────────────────────────────┐
│ 🔴 🟡 🟢  src/auth/session.ts   [9:16]│  mac titelleiste mit dateipfad
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02   const decoded = await verify(); │  aktive zeile fokussiert
│ 03   if (!decoded.valid) {     ┌─────┼─ 01 Token-Validierung
│ 04     throw new AuthError();  │     │
│ 05   }                               │  inaktive zeilen abgedunkelt
│ 06   return decoded.user;            │
├──────────────────────────────────────┤
│ > TERMINAL-AUSFÜHRUNG                │  ausziehbares terminal
│ > POST /api/v1/auth/verify HTTP/1.1  │  animierte stdout-protokollierung
│ > Status: 200 OK (14.2ms)            │
└──────────────────────────────────────┘

Erste Verwendung

Das Verzeichnis dieses Skills ist das Basisverzeichnis des Skill-Pakets.

# Überprüfen, ob Python 3 installiert ist
python3 --version || python --version

Läuft eigenständig ohne externe KI-API-Schlüssel, schwerwiegende Abhängigkeiten oder kostenpflichtige Cloud-APIs. Verwendet Headless-HTML5-Canvas/SVG mit optionalem Playwright, Puppeteer oder ffmpeg für Headless-MP4-Rendering.


Agenten-Ausführungsschritte

  1. Code & Storyboard: Frage den Benutzer nach dem Code-Snippet oder extrahiere es aus seiner Anfrage. Identifiziere die Kern-Erzählung:
    • Welche Sprache? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS).
    • Was ist der Fokus? (z.B. ein async-await-Aufruf, ein Dekorator, ein Fehlerwurf, eine rekursive Rückgabe).
    • Welche Terminalausgabe oder welches Ausführungsergebnis beweist, dass es funktioniert?
  2. Spezifikationserstellung: Schreibe <name>.code.json (Spezifikation siehe unten) im Arbeitsverzeichnis.
  3. Erstellen & Rendern: Führe das Builder-Skript aus:
    python build.py <name>.code.json
    
    • Für eine sofortige interaktive HTML-Wiedergabe öffne die generierte <name>.motion.html.
    • Um einen statischen Frame-Schnappschuss zu betrachten: python build.py <name>.code.json --snap 4.5.
    • Um die Schema-Syntax zu validieren: python build.py <name>.code.json --validate.
  4. Qualitätskontrolle:
    • Code-Zeilen passen bequem ohne horizontalen Überlauf (maximal 48 Zeichen pro Zeile für 9:16-Mobilgeräte empfohlen; maximal 80 für 16:9).
    • Callouts sind präzise, nummeriert von 01 bis 03 und zeigen klar auf die Zielzeilen.
    • Die Terminalausgabe spiegelt realistisches Ausführungsverhalten wider.
  5. Übergabe: Liefere den gerenderten HTML-/Videopfad und die Spezifikationszusammenfassung an den Benutzer.

Spezifikationsformat (<name>.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": "Async-Verifikation",
      "note": "Erwartet kryptografische Signatur",
      "side": "right"
    },
    {
      "line": 4,
      "label": "Guard-Klausel",
      "note": "Lehnt abgelaufene JWT-Payloads ab",
      "side": "right"
    }
  ],
  "terminal": {
    "enabled": true,
    "title": "Server-Ausgabe (Node.js v22)",
    "commands": [
      "$ curl -X POST https://api.dev/auth/verify",
      "> Verifiziere HMAC-SHA256-Signatur...",
      "> Token verifiziert: user_id=4092 [200 OK]"
    ]
  },
  "sound": {
    "typewriterClicks": true,
    "completionChime": true
  },
  "durationSeconds": 8.0
}

Parameterdefinitionen

  • title: Zeichenkette, die in der Fensterkopfleiste angezeigt wird (z.B. Dateiname oder Modulpfad).
  • language: "javascript", "typescript", "python", "rust", "go", "sql", "bash".
  • aspectRatio: "9:16" (Vertikales Reel für TikTok/Shorts/Instagram) oder "16:9" (Horizontales Breitbild).
  • theme: "obsidian" (tiefes Dunkelviolett), "onedark" (Atom-inspiriert), "monokai" (klassisch hoher Kontrast) oder "cyberpunk" (Neon-Cyan/Magenta).
  • code: Array von Zeichenketten, die jeweils eine Codezeile darstellen.
  • focusLines: Array von 1-basierten Zeilennummern, die bei 100% Helligkeit bleiben, während andere Zeilen abgedunkelt werden.
  • callouts: Optionale Liste von Annotationen. Maximal 3 Callouts empfohlen.
    • line: 1-basierte Zeilennummer, an der die Führungslinie verankert wird.
    • label: Kurze Großbuchstaben- oder fette Überschrift (maximal 18 Zeichen).
    • note: Erklärender Untertitel (maximal 28 Zeichen).
  • terminal: Optionales unteres Bedienfeld mit Stdout-Befehlen und Antworten.
  • sound: Optionale Einstellungen für prozedurale Synthese der Web Audio API (Tippgeräusche und Klingelton).
  • durationSeconds: Gesamtdauer der Animation (Standard: 8,0 s).

Unterstützte Plattformen

PlattformIntegrationsmethode
Claude / Claude CodeGeladen über SKILL.md in ~/.claude/skills/code-motion-director/ oder im Workspace .claude-plugin/
Google AntigravityRegistriert unter .gemini/antigravity/skills/code-motion-director/
ChatGPT / Custom GPTsKonfiguriert via benutzerdefinierte Anweisungen mit Datei adapters/chatgpt-instructions.md
Google GeminiEingefügt über Systemanweisung mit Datei adapters/antigravity-gemini.md

Geschmack & Ästhetikstandards

  • Klare visuelle Hierarchie: Halte den Code sauber, formatiert und lesbar. Minifizierten Code niemals einfügen.
  • Präzise Callouts: Callout-Notizen sollten technische Fakten sein, kein Marketing-Hype („Erwartet Promise“, nicht „Super cooles Feature!“).
  • Kontrast & Lesbarkeit: Stelle stets sicher, dass die Code-Schriftgröße für mobile Smartphone-Bildschirme ausreichend ist (mindestens 28px auf einer 1080x1920 Leinwand).
  • Tempo: Das Tippen sollte sich natürlich anfühlen (25–40ms pro Zeichen). Die Terminalausgabe sollte erscheinen, nachdem der Code fertig getippt wurde.

Verwandte Skills