/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
- 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?
- Spezifikationserstellung: Schreibe
<name>.code.json(Spezifikation siehe unten) im Arbeitsverzeichnis. - 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.
- Für eine sofortige interaktive HTML-Wiedergabe öffne die generierte
- 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.
- Ü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
| Plattform | Integrationsmethode |
|---|---|
| Claude / Claude Code | Geladen über SKILL.md in ~/.claude/skills/code-motion-director/ oder im Workspace .claude-plugin/ |
| Google Antigravity | Registriert unter .gemini/antigravity/skills/code-motion-director/ |
| ChatGPT / Custom GPTs | Konfiguriert via benutzerdefinierte Anweisungen mit Datei adapters/chatgpt-instructions.md |
| Google Gemini | Eingefü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.