Communitygithub.com

flutter-demo-reel

Erstellt aus einer Flutter-App ein Endlos-Promo- oder Demo-Reel-Video für soziale Medien (16:9 und 9:16, 60 fps) als separate macOS-Flutter-App in <app>/demo mit 3D (flutter_scene/Flutter GPU), 2D-Partikeln und Titel-Kit, sowie Offline-Export als H.264 und ProRes per ffmpeg.

Was ist flutter-demo-reel?

Diese Skill generiert automatisch ein kurzes, sich wiederholendes Promo-Video aus einer bestehenden Flutter-App. Es erstellt eine eigenständige macOS-Flutter-App im `demo/`-Ordner der App, rendert jedes Einzelbild offline („Frame-by-Frame“) und kodiert das Ergebnis in videofreundliche Formate. Der Reel nutzt echte Screens, Grafiken, Schriftarten und Inhalte der Original-App, ergänzt um eine 3D-Ebene mit flutter_scene (Flutter GPU auf Metal), ein 2D-Partikel- und Titel-Kit sowie auf die Musik abgestimmte Schnitte. Der Skill ist unter anderem für Claude Code, Cursor und Codex geeignet, setzt aber macOS mit Flutter-Desktop, ffmpeg und Python 3 voraus. Er funktioniert nach einem festgelegten Workflow: Zunächst führt er ein Interview mit dem Nutzer, analysiert den Soundtrack, schreibt ein bestätigtes Script, erstellt das Grundgerüst, baut den Reel Schritt für Schritt auf (immer mit stillen Tests per Stills und Kontaktbögen), exportiert schließlich in H.264 und ProRes und liefert dem Nutzer die Dateien zur Nachbearbeitung. Der Skill stellt sicher, dass die App nie verändert wird – alle benötigten Ressourcen (Grafiken, Fonts, Screenshots, Inhalte, Theme-Farben) werden in den `demo/`-Ordner kopiert. Jeder Frame ist eine reine Funktion von `t` (Zeit), ohne Zustand zwischen Frames, ohne `Random()`, ohne Clocks – dadurch funktionieren Scrubbing, chunked Export, Bewegungsunschärfe und nahtlose Loops. Vor dem Start muss der Nutzer ein detailliertes Interview führen, um Länge, Loop, Soundtrack, Botschaft, Look, echte Screens und On-Screen-Text festzulegen. Der gesamte Bauvorgang ist stark referenziell auf die mitgelieferten Unterlagen (`references/kit.md`, `references/flutter-scene.md`, `references/audio-sync.md`, `references/craft.md`) angewiesen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vlidholt/flutter-skills/tree/HEAD/skills/flutter-demo-reel

In Ihrer bevorzugten KI fragen

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

Dokumentation

Flutter Demo Reel

Baue ein kurzes, sich wiederholendes Promo-Video für eine Flutter-App als eigene macOS-Flutter-App im Ordner <flutter app>/demo, rendere es offline Bild für Bild und kodiere es. Der Reel verwendet die echten Screens, Grafiken, Schriftarten und Inhalte der App, eine 3D-Ebene auf flutter_scene (Flutter GPU auf Metal), ein 2D-Partikel- und Titel-Kit und Schnitte auf die Musik.

Die Pfade unten beziehen sich auf den Ordner dieses Skills (den Ordner, der diese SKILL.md enthält). In Claude Code ist dieser Ordner ${CLAUDE_SKILL_DIR}.

Grundregeln

  • Ändere niemals die App. Kopiere, was du brauchst (Grafiken, Schriftarten, Screenshots, Inhaltsdaten, Theme-Farben) in demo/. Das Grundgerüst fügt nur demo/** zu den Analyzer-Ausschlüssen des übergeordneten Pakets hinzu.
  • Jeder Frame ist eine reine Funktion von t. Kein Zustand zwischen Frames, kein Random(), keine Uhren, keine Simulation: geschlossene Bewegungsformeln, gesetzte Zufälligkeit. Das macht Scrubbing, chunked Export, Bewegungsunschärfe und einen nahtlosen Loop möglich. Lies references/kit.md, bevor du Shots schreibst.
  • Befolge die Stimmregeln des Projekts (AGENTS.md, CLAUDE.md oder ähnlich): Wörter, die die App nie verwendet, wie sich das Produkt selbst nennt, Ton.
  • Vereinbare vor dem Bauen. Befrage den Nutzer, schreibe dann ein Drehbuch, das er genehmigt.
  • Nur macOS. Benötigt Flutter mit macOS Desktop, ffmpeg (brew install ffmpeg) und Python 3 mit Pillow (Kontaktbögen) und numpy (Audioanalyse).

Arbeitsablauf

1. Befragung

Frage, bevor du beginnst, und gib jeweils einen Standardwert an, damit der Nutzer schnell antworten kann:

  1. Länge und Loop (Standard 30 s, nahtloser Loop), Formate (Landscape 1920x1080 und Portrait 1080x1920, Portrait für Reels, TikTok und Shorts konzipiert), 60 fps.
  2. Soundtrack: eine Datei (mit Text?) oder keine, und wem die Rechte gehören.
  3. Die Botschaft: die 3–5 Dinge, die gezeigt werden sollen, der Handlungsaufruf (URL, Store-Badges), Behauptungen (kostenlos? Bewertungen? Zählungen?).
  4. Look und Ton: wie übertrieben, die Marke der App, etwaige Referenzen.
  5. Echte Screens: welche und darfst du die App ausführen, um sie zu erfassen (Testkonto, vorgegebene Daten)? Auch erfundene Atmosphären-Shots?
  6. Text auf dem Bildschirm: nur Schlüsselwörter (Standard) oder vollständige Untertitel, Schreibweise des Produktnamens, zu vermeidende Wörter.
  7. Etwas Besonderes: Easter Eggs, Charaktere, Dinge, die niemals gezeigt werden sollen.

2. App studieren

Lies das Theme der App (Farben, Schriften), Assets (Logos, Charaktere, Icons), Inhalte (echte Namen, Zahlen, anzuzeigende Daten) und ihre Hauptbildschirme. Notiere, was sie auszeichnet. Plane die Screenshots und erfasse sie oder bitte den Nutzer darum (siehe „Echte Screenshots“ in references/craft.md).

3. Soundtrack analysieren

python3 scripts/analyze_audio.py <track>

Wandle sein Tempo, seine Beat-Phase, seine Abschnitte und Gesangslinien in benannte Cues um, wie in references/audio-sync.md. Ohne Soundtrack wähle trotzdem ein Tempo und schneide auf dessen Raster.

4. Drehbuch schreiben

Erstelle eine zeitgesteuerte Tabelle mit für jeden Shot: die Musik oder den Text, das Landscape-Bild, das Portrait-Bild und den Text auf dem Bildschirm (Vorlage in references/craft.md). Markiere den Hook, den Drop, die Endcard und die Loop-Naht. Hole die Zustimmung des Nutzers ein und iteriere, bis er grünes Licht gibt.

5. Grundgerüst erstellen

zsh scripts/scaffold.sh <flutter app dir>

Führe es mit dem vollständigen Pfad zum scripts/-Ordner dieses Skills aus; es funktioniert von jedem Verzeichnis aus. Es:

  • erstellt <app>/demo mit flutter create --platforms macos;
  • fügt flutter_scene, vector_math und audioplayers hinzu und führt flutter_scene:init aus;
  • aktiviert Flutter GPU (FLTEnableFlutterGPU) und schaltet die App-Sandbox aus (der Exporter führt ffmpeg aus);
  • kopiert das Starter-Kit aus assets/template/, erstellt art/, art/screens/, audio/ und fonts/ und ignoriert out/;
  • schließt demo/** vom Analyzer des übergeordneten Pakets aus.

Es funktioniert in Pub Workspaces (das Demo bleibt ein eigenständiges Paket) und weigert sich, einen vorhandenen Ordner zu überschreiben.

Konfiguriere dann:

  • lib/core/timeline.dart: kDuration, kBpm, kBeatPhase und die Cues.
  • lib/core/format.dart: Palette aus dem Theme der App und Fonts (kopiere die Schriftartdateien in demo/fonts/ und deklariere sie in pubspec.yaml).
  • Assets: art/ (Unterordner in pubspec.yaml auflisten) und audio/track.wav (48 kHz PCM).

Baue einmal und rendere die Beispiel-Stills, um zu beweisen, dass das Setup funktioniert:

cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both

6. Reel bauen

Ersetze lib/shots/example.dart durch einen Abschnitt pro Teil des Drehbuchs, liste sie in Director.sections auf und setze die Kamera-Treffer in Director._hits. Arbeite Abschnitt für Abschnitt:

  1. Schreibe den Abschnitt (3D-Frame und 2D-Layer darunter und darüber) mit dem Kit (references/kit.md) und flutter_scene (references/flutter-scene.md).
  2. Führe flutter build macos --profile aus, rendere dann Stills zu den Schlüsselmomenten des Abschnitts in beiden Formaten: tool/run.sh stills "t1,t2,..." both.
  3. Erstelle einen Kontaktbogen pro Format und überprüfe ihn, plus einzelne Stills aus der Nähe, wo Details wichtig sind: python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png. Wenn du Bilder nicht ansehen kannst, teile dem Nutzer mit, welche Stills er überprüfen und worauf er achten soll. Behebe es und wiederhole.

Führe die Überprüfungs-Checkliste in references/craft.md für den gesamten Reel durch, bevor du exportierst. Der Nutzer kann ihn mit der Musik in der Vorschau-App ansehen (open build/macos/Build/Products/Profile/*.app); Stills können Timing nicht zeigen.

7. Exportieren

tool/export.sh draft both     # 1x, keine Bewegungsunschärfe: eine schnelle vollständige Überprüfung
tool/export.sh final both     # 2x supersampled, 4-Sample Bewegungsunschärfe

Ein finaler Export dauert etwa 10–15 Minuten pro Format für 30 s. Führe ihn im Hintergrund aus, wenn deine Umgebung das zulässt, und poll ihn nicht. Überprüfe danach die Dateien mit ffprobe: die Bildanzahl ist kDuration * kFps, die Dauer stimmt und es gibt einen Audiostream. Ziehe ein paar Frames aus den MP4s, einschließlich des letzten Frames und Frame 0 (der Loop-Naht).

8. Liefern und iterieren

Gib dem Nutzer die Pfade (demo/out/final/<format>.mp4 zum Hochladen, <format>_master.mov ProRes zum Bearbeiten), die Dateigrößen und was zu überprüfen ist. Erwarte Anmerkungen. Typische, mit Korrekturen, findest du in references/craft.md: Text zu kurz gehalten, Text verdeckt, unerwünschte Untertitel, Nähte in Umrissen, harte Lichtstrahlen, eine Reihe von Elementen, die gleich aussehen, Portrait-Formulierung. Behebe alle Anmerkungen in einem Durchgang, bevor du neu renderst.

Dateien

  • references/kit.md: Architektur und APIs des Starter-Kits.
  • references/flutter-scene.md: Einrichtung von flutter_scene, Look und Offline-Fallstricke.
  • references/audio-sync.md: Tempo, Phase, Text und Cues aus einem Track.
  • references/craft.md: Drehbuch-Vorlage, Textregeln, Effekt-Rezepte, Screenshots, die Überprüfungs-Checkliste.
  • scripts/scaffold.sh: Erstellt die Demo-App.
  • scripts/analyze_audio.py: Tempo, Beat-Phase, Lautstärke pro Takt, Einsätze.
  • assets/template/: Das Starter-Kit, das das Grundgerüst kopiert.

Verwandte Skills