Communitygithub.com

motionable: Film-Pipeline

Interne motionable-Pipeline (Planmodus, Freigabe, Szenen, Musik, Kritik, Rendern). Starte mit /motionable:scratch, :website oder :project.

Was ist motionable: Film-Pipeline?

Diese Skill-Anleitung beschreibt die vollständige Erstellung eines Werbefilms für ein Produkt mit der motionable-Engine. Sie führt den KI-Agenten Schritt für Schritt durch den gesamten Prozess: von der Analyse der Produktpersönlichkeit und dem Erstellen eines Direction-Dokuments über die Freigabe und den Bau der Film-Szenen in Swift bis hin zur Selbstkritik und finalen Auslieferung. Die Pipeline ist auf Zusammenarbeit ausgelegt – nach jedem Draft gibt es eine Freigaberunde mit gezielten Fragen an den Nutzer. Plattformunabhängig nutzbar für Claude Code, Cursor, Codex oder ähnliche Tools, die Markdown-Anweisungen ausführen können. Sie stellt sicher, dass jeder Film einzigartig ist, indem sie die Fingerabdrücke anderer Filme im Studio vergleicht und Abweichungen erzwingt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

In Ihrer bevorzugten KI fragen

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

Dokumentation

motionable: make

Du erhältst Fakten über ein Produkt (jeweils mit Quelle), die Antworten des Nutzers, Bildpfade, Farben und Notizen zu seiner Persönlichkeit. Deine Aufgabe ist ein fertiger Film, der sich wie dieses Produkt anfühlt – und wie kein anderer Film im Studio.

ROOT ist das motionable-Wurzelverzeichnis: ${CLAUDE_PLUGIN_ROOT}. Falls das nicht expandiert, nutze den Ordner zwei Ebenen über dem echten Pfad (realpath) dieser Datei, der engine/ und scripts/ enthält.

Lies ROOT/PLAN.md (Planmodus), ROOT/ENGINE.md (die Zutaten), ROOT/rules.md (harte Regeln) und ROOT/checklist.md (Kritik), bevor du planst. ROOT/examples/owly/ zeigt, wie fertige Arbeit aussieht. Kopiere niemals dessen Aussehen, Sound oder Struktur: Es ist eine Richtung unter unendlich vielen.

1. Erstelle den Film

  • Wo: Filme leben im aktuellen Ordner (normalerweise das Studio des Nutzers für Hype-Videos), als <slug>/.
    • Wenn der aktuelle Ordner das eigene Repository des Produkts ist, nutze stattdessen motionable/<slug>/.
    • Schreibe niemals in einen Produktordner, der über /motionable:project übergeben wurde.
    • Falls <slug>/ existiert, frage: Neue Version erstellen (<slug>-2/) oder diesen Film fortsetzen?
  • Erstelle ihn: Führe bash ROOT/scripts/new.sh <film> "<Produktname>" aus. Es kopiert die Engine in den Film und schreibt die Vorlagen.
  • Assets: Kopiere die Bilder in <film>/assets/ mit klaren Namen (logo.png, screen-home.png…). Eine Brand-Schriftart-Datei, falls der Nutzer eine hat, kommt nach assets/fonts/.

2. Planmodus (intern: kein Befehl, kein Stilmenü)

Folge PLAN.md von Anfang bis Ende:

  1. Beweistafel und Persönlichkeit.
  2. Geschichte: Versprechen, Signature-Moment, 3 Hooks → 1.
  3. Jeder Regler gesetzt, jeweils mit Begründung.
  4. Einzigartigkeit gegenüber dem Studio: Lies die DIRECTION.md der anderen Filme › Fingerabdruck. Filme vor v0.2 haben keinen; behandle sie als 120 BPM a-Moll House mit linksbündigen Überschriften über einer Karte.
  5. Schreibe DIRECTION.md und SCRIPT.md im gewählten Tempo.

Bitte den Nutzer nicht, einen Stil auszuwählen. Die Richtung kommt aus den Beweisen.

3. Eine Freigabe

Zeige die 4-zeilige Treatment (Feel · Sound · Look · Signature-Moment) und ein kompaktes Beat-Raster (Zeit · Bild · Worte · Join). Frage dann, mit AskUserQuestion falls verfügbar (sonst im Chat):

  1. Der Plan: genehmigen oder etwas ändern.
  2. Illustrationen: „Soll ich Illustrationen für diesen Film zeichnen?“ Ja, illustrieren / Ein paar Akzente / Nein, nur Screenshots und Schrift. Empfehle eines mit Begründung (PLAN.md §5).
    • Sie zu zeichnen ist kostenlos: Claude schreibt SVGs.
    • Nur wenn die Sitzung ein Bildgenerierungswerkzeug angeschlossen hat, füge es als Option hinzu und sage, dass es Geld kosten kann.

Schreibe keinen Szenencode vor der Freigabe. Eine Änderung hier ist billig.

4. Bauen

  1. Illustrationen (falls ja): Schreibe die SVGs in assets/drawn/ in den Brand-Farben und einer Linienstärke (ENGINE.md › Gezeichnete Illustrationen). Betrachte jede auf einem Blatt gerendert und zeichne alles Unförmige neu.
  2. scenes/Film.swift: Ersetze das Skelett vollständig. Jeder Wert kommt aus DIRECTION.md und SCRIPT.md:
    • die Zeiten gehen in enum T;
    • Clips und Joins gehen in ein Reel;
    • Screens gehen durch die Rahmungsaufrufe (niemals in eine feste Box geclippt);
    • der Signature-Moment wird neu gezeichnet, um genau wie die echte UI zu animieren. Miss zuerst, wo er sitzt: bash ROOT/scripts/inspect.sh <screenshot> find <seine Farbe> (oder row, column, pixel) gibt exakte Ringe, Balken und Textkanten.
    • Benutzerdefinierte Elemente, die die Richtung braucht, kommen in eigene scenes/*.swift-Dateien.
  3. Sound: Das Rezept der Richtung + Abschnitte via s.compose, plus ein s.cue für jedes Bildereignis, mit den Signature-Sounds.
  4. Prüfe, ob es baut: bash ROOT/scripts/run.sh <film> sheet (ohne Zeiten: der gesamte Film plus jeder Join). Behebe Kompilierungsfehler (ENGINE.md › Fallstricke).

5. Entwurf, beheben, dann dem Nutzer zeigen

Arbeite in Entwürfen und schleife niemals endlos:

  1. Entwurf 1 ist der erste vollständige Build: Szenen, Musik und jeder Cue. Überprüfe ihn direkt aus dem Film (die Schritte unten); du brauchst dafür keine Videodatei. (run.sh <film> draft rendert ein kleines, schnelles MP4, falls der Nutzer einen frühen Blick haben möchte.)
  2. Selbstkritik: ein Durchlauf, und jede Prüfung.
    • run.sh <film> check: jedes ✗ ist ein Muss-Fix. Halte die Zeile länger, starte sie früher, kürze Wörter oder lass sie weg. Eine getippte Zeile braucht ihre Tippzeit plus ihre Lesezeit. Reagiere auch auf die ⚠-Ratschläge (Bild 1, Rhythmus), es sei denn, DIRECTION.md sagt, warum nicht.
    • run.sh <film> sheet: Bewerte jede Kategorie in checklist.md und behebe alles unter 8. Betrachte stills in voller Größe vom Hook, dem Signature-Moment und der Endkarte: Ist die UI lesbar, kollidiert etwas, tut jede Ecke des Bildes etwas oder ist bewusst leer?
    • Was Zuschauer bestrafen (RESEARCH.md › Community-Check): UI zu klein zum Lesen, Hüpfen bei großen Dingen, Einstellungen einer Länge, stockklingende Musik, ein langsamer Logo-Moment.
    • run.sh <film> audio, dann bash ROOT/scripts/compare.sh <film>: Wenn ein anderer Film zu ähnlich ist, ändere das Rezept aus einem Grund.
    • Gehe den gesamten Film Schritt für Schritt durch: run.sh <film> sheet $(seq 0.5 1 <laenge>) (ein Bild pro Sekunde). Suche nach dem, was einzelne Stills verbergen: eine Szene, die sich leert, ein Beat ohne Bewegung, ein Join, der aus dem Rahmen fällt, eine Zeile, die genau erscheint, wenn die Szene verlassen wird.
  3. Entwurf 2. Behebe alles, was in einem Durchlauf gefunden wurde, und führe dann check und sheet erneut aus.
    • Wenn etwas immer noch fehlschlägt, erlaube einen weiteren Fix-Durchlauf höchstens.
    • Wenn es danach immer noch fehlschlägt, mach nicht weiter: Sag dem Nutzer, was übrig ist und warum.
    • Führe ein kurzes Kritik-Log in SCRIPT.md: was sich geändert hat und warum.
  4. Rendere die echte Datei: run.sh <film> video, etwa 45 s für 30 s.
  5. Zeige sie und frage (AskUserQuestion falls verfügbar). Sende das MP4, das 4-zeilige Treatment und das Kritik-Log, dann stelle 3–4 gezielte Fragen zu diesem Schnitt. Jede benötigt eine empfohlene Option, und „Sonstiges“ lässt den Nutzer alles sagen:
    • Tempo: fühlt sich richtig an / langsamer, weniger Zeilen / schneller, mehr Punch.
    • Sound: behalten / mehr Energie / ruhiger / andere Instrumente.
    • Hook: behalten, oder den stärksten der beiden anderen Hook-Kandidaten aus dem Planmodus, benannt.
    • Ende: behalten / ein launch-sicheres Ende (z. B. kein Download-Badge, bevor die App live ist) / den Preis hinzufügen.
  6. Überarbeite einmal pro Antwortrunde, führe check und audio und compare erneut aus und zeige dann den neuen Schnitt. Nach zwei Nutzerrunden biete an, aufzuhören oder fortzufahren; der Nutzer entscheidet.

6. Badges speichern (nur wenn das Produkt live ist)

  • App Store live und der Nutzer möchte ein Badge: Bitte um Erlaubnis, Apples offizielles Badge herunterzuladen (etwa 11 KB, schwarz, englisches SVG; URL in rules.md) nach assets/.
    • Zeichne es mit drawAppStoreBadge, statisch und niemals animiert; Betonung kommt von glowRing.
    • Wenn der Nutzer darauf besteht, es zu animieren, erkläre Apples Regel einmal. Wenn er es immer noch möchte, mache daraus eine separate, klar benannte Variante.
  • Google Play: Sein Badge nur, wenn die App dort live ist und der Nutzer den Download genehmigt. Ansonsten höchstens eine Klartextzeile, und nur, wenn es wahr ist.

7. Liefern

Füge bei jedem gezeigten Schnitt bei:

  • das Treatment in wenigen Zeilen;
  • was die Selbstkritik behoben hat;
  • das Vergleichsergebnis und das check-Urteil;
  • die Behauptungen, die vor dem Posten zu überprüfen sind;
  • wie man es ändert: SCRIPT.md oder DIRECTION.md bearbeiten, oder einfach sagen.

Nachdem der Nutzer zufrieden ist, biete die nächsten nützlichen Dinge an:

  • ein 15-s-Schnitt, oder ein anderes Format (1:1, 16:9);
  • Hook-Varianten für einen A/B-Test: derselbe Film eröffnet mit den anderen beiden Hook-Kandidaten aus dem Planmodus;
  • ein launch-sicheres Ende (kein „Download“, bevor die App live ist);
  • eine Effekte-only-Version (run.sh <film> video effects), zum Posten mit einem Plattform-Sound oder einem lizenzierten Track.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills