checklist-overlay
Ein Screen-Recording auf der linken Seite, eine Checkliste auf der rechten Seite. Jeder Punkt wird in dem Moment abgehakt, in dem sein Schritt auf dem Bildschirm sichtbar ist. Nach dem letzten Haken bleibt das Bild auf der vollständig abgehakten Liste stehen.
Eingaben
| Eingabe | Hinweise |
|---|---|
| Recording | Eine lokale Videodatei, idealerweise 16:9. Stumm ist in Ordnung. |
| Schritte | 3 bis 7 Einträge: { "label": "...", "at": <Sekunden im Recording> }. Labels sind kurze Aufforderungssätze (ca. 2 bis 4 Wörter). |
| Titel | Eine Zeile. Nenne das Ergebnis („Hole ein Skill in deinen Agenten in 5 Schritten“). |
| Untertitel | Optional eine Zeile. |
| Farbpalette | Optionale Hex-Überschreibungen: bg, surface, panel, ink, muted, accent, border, accentInk. Standard ist dunkel mit einem orangefarbenen Akzent. accentInk sollte dunkel genug sein, um auf accent lesbar zu sein. |
Gibt die Person keine Zeitstempel an, so scrolle durch das Recording (extrahiere alle 1 bis 2 s mit ffmpeg Frames, betrachte sie) und wähle den ersten Frame, in dem jeder Schritt sichtbar erledigt oder im Gange ist. Nicht raten.
Arbeitsablauf
- Lade
/hyperframes,/hyperframes-core,/hyperframes-clifür den Projektvertrag. - Schreibe
spec.json:{ "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" }, "steps": [ { "label": "App öffnen", "at": 1.5 }, { "label": "Suchen", "at": 7.9 } ] } - Generiere die Komposition in das Projektverzeichnis:
node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2]Es kopiert das Recording, extrahiert den letzten Frame (damit das Bild nach dem Ende des Recordings stehen bleibt) und schreibtindex.htmlin der Größe des Recordings. Gesamtlänge = Recording-Länge + Haltezeit (Standard 2,2 s). npx --yes hyperframes checkmuss mit 0 Fehlern und 0 Warnungen bestehen.- Validieren (siehe unten), dann rendern:
npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4.
Timing-Regeln
- Der Haken erscheint genau im Schritt, nie davor. Die Füllung und die Haken-Zeichnung beginnen bei
t = at; die Zeichnung endet etwa 0,3 s später. Nichts im Eintrag darf voratwie abgehakt aussehen. - Zeitstempel beziehen sich auf die Recording-Zeit und das Recording beginnt bei Kompositionszeit 0, daher wird
atunverändert verwendet. Wenn du das Recording kürzt, verschiebe jedesatum den gleichen Betrag. - Ein „Als nächstes“-Umriss kann kurz nach dem vorherigen Haken im nächsten Eintrag erscheinen. Es ist nur ein Umriss, niemals eine Füllung oder ein Haken.
- Halte mindestens 1,5 s Abstand zwischen den Haken, damit jeder lesbar ist. Wenn zwei Schritte näher beieinander liegen, fasse sie zusammen.
- Der letzte Haken sollte mindestens 1,5 s vor Ende des Recordings liegen, oder erhöhe
--hold, damit die fertige Liste 2 s oder länger sichtbar ist. - Zähler (
n / N), Fortschrittsbalken und Frame-Ring-Puls leiten alle von denselbenat-Werten ab, damit sie synchron bleiben.
Layout (16:9-Recordings)
1920x1080 Leinwand, 56 px Ränder. Titel und Untertitel oben; der Recording-Rahmen ist das Hauptelement mit etwa 1250 px Breite (etwa 65 % der Breite), die Checkliste ist eine 520 px breite Spalte rechts daneben, gleiche Höhe wie der Rahmen, die Einträge teilen sich die Höhe gleichmäßig auf. Dadurch bleibt UI-Text im Recording lesbar. Verkleinere den Rahmen nicht unter etwa 1100 px Breite; bei einem höheren Recording skaliert der Generator den Rahmen proportional zum Seitenverhältnis. Bei Aufnahmen, die nicht 16:9 sind: Prüfe, ob der Rahmen noch unter den Header passt, oder schneide das Recording vorher zu.
Labels werden bei 32 px auf zwei Zeilen umbrochen; halte sie unter etwa 26 Zeichen.
Validierung
Führe dies am gerenderten final.mp4 durch, nicht nur an Standbildern:
- Für jeden Schritt extrahiere einen Frame 0,08 s vor
atund einen 0,45 s nachat:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png. - Sieh sie an. Davor: Eintrag nicht abgehakt, Zähler bei i-1. Danach: Eintrag gefüllt mit Haken, Zähler bei i, Fortschrittsbalken vorgerückt.
- Extrahiere einen Frame im finalen Stillstand (etwa 0,2 s vor Ende): alle Einträge abgehakt, Zähler
N / N, Balken voll. - Überprüfe, dass der Recording-Text im Rahmen lesbar ist und kein Label abgeschnitten wird. Korrigiere
spec.jsonoder die Farbpalette und generiere neu, falls nicht. ffprobedie Datei: 1920x1080, h264, Dauer = Recording + Haltezeit.
Auslieferung
Berichte den Pfad zu final.mp4, dessen Dauer und die verwendeten Schritt-Zeitstempel. Behalte das Projektverzeichnis (index.html, assets/, spec.json), damit der Film mit anderen Labels oder Farbpaletten neu generiert werden kann. Öffne zuerst npx hyperframes preview, falls die Person im Studio bearbeiten möchte.
</fenced_code_block>