Communitygithub.com

TurkiHassan/period-launch-video

Erstelle ein 24-sekündiges, quadratisches (1440², 60 fps) Endlos-Loop-Produktlaunchvideo, bei dem die gesamte Geschichte *innerhalb des Punkts im Wortmarken-Logo* abläuft – mit Irisblende, Glas-UI und beat-synchronen Soundeffekten.

Was ist period-launch-video?

Diese Skill ermöglicht die Erstellung eines 24-sekündigen quadratischen Loop-Videos (1440×1440 Pixel, 60 fps) für Produktlaunches. Die gesamte Handlung spielt sich *innerhalb des Punkts einer Wortmarke* ab (z.B. der Punkt über dem „i“ oder einem anderen Buchstaben). Zu Beginn öffnet sich eine Irisblende auf ein Nachtfoto, eine Glas-UI mit Pillen und Panels blendet sich ein und zeigt die Produktgeschichte in sechs Stufen: Ask → Find → Write → Night → Results → Phone Lock Screen → Proof → Call-to-Action. Zum Schluss schließt sich die Blende wieder, und der Punkt erscheint neben dem App-Icon. Die Skill nutzt eine einzige HTML/Canvas-Sequenz mit reinem seek(t)-Timing, Playwright fürs Rendering mit Bewegungsunschärfe, beat-synchronen SFX bei -14 LUFS sowie einer arabischen RTL-Vorlage (Geist + Thmanyah Sans, sonst IBM Plex Sans Arabic). Alles ist konfigurationsgesteuert über `config.js`. Die Skill kann auch passende Nacht-/Tag-Fotos über Higgsfield, lokale Codex image_gen oder fertige Prompts für Gemini/ChatGPT besorgen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add TurkiHassan/period-launch-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht period-launch-video?

Ein 24 s Loop, in dem die gesamte Aufgabe des Produkts innerhalb des Punkts seiner Wortmarke abläuft. Alles wird in template/ ausgeliefert: der Renderer (index.html, alle Inhalte in config.js), die Render-, Scan- und Audio-Skripte, Schriftarten, der echte macOS-Zeiger und ausgesteuerte SFX. Ihre Arbeit besteht hauptsächlich darin, Inhalte und Fotos auszuwählen und dann die Pipeline auszuführen. Lesen Sie references/craft.md einmal, bevor Sie Bewegungen ändern. Dort stehen die Richtung, die Beat-Map und die bereits gelösten Fallstricke.

Workflow

1 · Einrichtung

~/.claude/skills/period-launch-video/scripts/new_project.sh <projekt>/brag-output/<slug>

Legen Sie die Ausgabe im Projekt des Benutzers ab. Verwenden Sie einen git-ignorierten Ordner wie brag-output/, falls vorhanden. Das Skript kopiert auch den echten macOS-Zeiger von diesem Mac (make_pointers.py, nicht weiterverteilt) und installiert Playwright. Um das Original-Look zu erzielen, legen Sie Thmanyah Sans woff2-Dateien (thmanyah-sans-{400,500,700}.woff2) in assets/fonts/ ab. Ohne diese wird IBM Plex Sans Arabic verwendet.

2 · Eingaben aus dem Projekt sammeln (nur nach Fehlendem fragen)

  • Identität aus der veröffentlichten Version. Verwenden Sie die App-Store-Screenshots, das iOS-Asset-Katalog (Icon, Farben) und die eigenen Beispieldaten und Texte der App. Ignorieren Sie veraltete Web-Assets. Wenn Sie nicht erkennen können, welche Version live ist, fragen Sie nach. Dies war die wichtigste Korrektur aus dem ersten Durchlauf.
  • Icon: Kopieren Sie das quadratische App-Icon in assets/img/icon.png. Die Vorlage wendet die iOS-Eckenmaske selbst an.
  • Song: Verwenden Sie den vorhandenen Track des Projekts, falls vorhanden; sonst fragen Sie nach. Führen Sie python3 find_hit.py assets/music/song.mp3 aus und setzen Sie config.song.hit (≈ der gemeldete Hit − 0.04) und bpm. enterAt (Standard 3.10) ist der Zeitpunkt, an dem der Hit einsetzt, bei der ersten Pille. Halten Sie enterAt + 20 beats bei etwa 13.5 s, damit „Results“ auf Beat 20 landet.
  • Texte: Füllen Sie config.js aus: Name (ein Wort, das zur schwarzen Wortmarke plus Punkt wird), Tagline, zwei Eröffnungszeilen, die Ask-Pille, die Aufgabe, Find/Write/Night-Labels, 3 Ergebnisse, Benachrichtigungen, 5 Bibliothekszeilen, den Diagrammwert und den CTA. Achten Sie darauf, dass alle Zahlen über die Beats hinweg konsistent sind. Westliche Ziffern. Bleiben Sie strikt bei JSON, da audio.py es parst.
  • Ehrlichkeitsprüfung: Wenn die Geschichte etwas impliziert, was das Produkt nicht tut (z.B. nächtliche Stapelverarbeitung), sagen Sie dies vor dem Rendern und bieten Sie neutrale Formulierungen an.

3 · Fotos (vier Platten)

Folgen Sie references/image-prompts.md. Wählen Sie den Weg je nach Verfügbarkeit:

  1. Higgsfield MCP mit Credits. Tag zuerst, dann Nacht und Morgendämmerung als Bearbeitungen des Tagesjobs, plus Außenansicht. Kosten vorab prüfen.
  2. Lokaler Codex (which codex). scripts/codex_image.sh verwendet Codex' integrierte Bildgenerierung über das ChatGPT-Abo des Benutzers.
  3. Keine Credits und kein Codex. Geben Sie dem Benutzer die vier ausgefüllten Prompts (Gemini für die Bearbeitungen) und warten Sie auf die Dateien.

Dann:

python3 check_align.py      # Nacht/Dämmerung müssen Verschiebung (0,0) gegenüber Tag haben
python3 grade_plates.py     # → assets/img/*.jpg + unscharfe Kopien; Vorschau out/plates.jpg

4 · Beat-Map + sechs Standbilder → Freigabe vor dem Rendern

node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25     # öffnen, finden, schreiben, ergebnisse, telefon, raus
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png

Betrachten Sie zuerst jedes Standbild selbst: Text passt, nichts abgeschnitten, Glas über der Platte lesbar. Zeigen Sie dem Benutzer dann das Blatt (SendUserFile) und eine aus T in index.html erstellte Beat-Map-Tabelle. Rendern Sie erst nach Freigabe.

5 · Rendern, prüfen, ausliefern

./build.sh out/<slug>-launch.mp4     # 4 Render-Worker → scan.py + scan_local.py → Timeline + Audio → H.264/AAC
  • scan.py muss eine Nahtdifferenz von ca. 0 (sauberer Loop) und keine Spitzen oder Stufen melden.
  • scan_local.py Hits sind in Ordnung, wenn es sich um Zähler oder Tippen handelt. Alles andere ist ein echter Aussetzer: Finden Sie heraus, welche Übergabe ihn verursacht hat, und beheben Sie ihn. Rendern Sie dann nur die betroffenen Frames mit node render.mjs a b neu und codieren Sie mit der ffmpeg-Zeile aus build.sh neu.
  • Ziehen Sie einen Frame am Ende jedes Zählers und bestätigen Sie, dass er die exakte Endzahl zeigt.
  • Melden Sie die Spezifikationen (1440², 60fps, 1440 Frames, 24.0 s, LUFS, Peak), alle offenen Ehrlichkeits-Flags und den Dateipfad.

Anpassung über die Voreinstellungen hinaus

  • Zeitliche Neuanpassung: Bearbeiten Sie T in index.html (behalten Sie 0,8 s Gleitphasen bei) und führen Sie dann node timeline.mjs && python3 audio.py erneut aus.
  • Bibliothekszeilen sind aufgrund des Layouts auf 5 festgelegt. Die Diagrammachse hat 3 Beschriftungen (Anfang, Mitte, Ende).
  • LTR-Produkte (englische Wortmarke): Die Vorlage ist RTL ausgelegt. Der Punkt sitzt am linken Ende, Zeilen und Pillen sind rechts ausgerichtet, und Scans und Diagramme verlaufen von rechts nach links. Für LTR spiegeln Sie diese Anker (align, die R/L-Ränder, scanX, cpt) und setzen Sie das Icon auf die linke Seite. Planen Sie Zeit dafür ein und prüfen Sie jedes Standbild.

Verwandte Skills