learnaiwithhugo/video-editor-skills

/edit-my-video

Rohe Clips rein, ein fertiger 1080×1920 Reel raus, im Stil des Benutzers. Der Benutzer ist in der Regel nicht technisch versiert: Sprich in kurzen, klaren Nachrichten, einen Schritt nach dem anderen, erledige die gesamte technische Arbeit selbst und lass sie niemals Code anfassen. Verwende niemals das AskUserQuestion-Popup (frage im Chat). Poste oder lade nichts irgendwo hoch. Keine Gedankenstriche in irgendetwas, das du für sie schreibst oder auf dem Bildschirm anzeigst.

„SK“ = der Ordner dieser Fähigkeit. „STYLE“ = der Stil-Ordner (Standard: der in SK/config.json gespeicherte, sonst der von /build-my-style erstellte, sonst ~/edit-style; wenn keiner eine STYLE.md hat, frage nach dem Speicherort oder schlage zunächst /build-my-style vor). „WORK“ = ein Ordner pro Video, <edits folder>/<slug>/ (slug = kurzer kebab-case, z. B. github-repos). Setze jeden Pfad in Anführungszeichen, sie enthalten Leerzeichen. Skripte laufen als python3 "SK/scripts/<name>.py" ...; jedes gibt bei Aufruf ohne Argumente die eigene Verwendung aus.

Lies vor dem ersten Schnitt einer Sitzung: references/creative-rules.md (die wichtigste Datei: wie man gestaltet, und die harten Geschmacksprüfungen) und references/engine.md (das HyperFrames-Muster, das rendert). Lies references/storyboard.md vor Schritt 4.

Die eine Regel, die am wichtigsten ist

Die STYLE.md ist Leitplanke, kein Menü. Sie legt das Aussehen fest (Farben, Schriftart, Bewegungsgefühl, Lautstärkepegel, sichere Zone, was abgelehnt wurde). Sie schränkt nicht ein, was du erstellst. Frage dich bei jeder Zeile, welche Visualisierung die Idee am besten erklärt, und entwerfe sie dann innerhalb des Look frisch. Der erste Testschnitt kopierte Vorlagen aus der Stilseite (eine Checkliste, dass „es nur drei Dinge kann“) und der Ersteller nannte es „extrem eingeschränkt“ und „hat überhaupt nichts improvisiert“. Variiere die Layouts; niemals dasselbe Layout zweimal hintereinander; mache Visualisierungen groß.

Schritte (Sage in einer kurzen Zeile, bei welchem Schritt du bist: „Schritt 3 von 8: Finde deine besten Takes“)

1. Setup-Prüfung (Sekunden)

python3 "SK/scripts/setup.py" --check. Zeige fehlende Elemente als kurze Liste: was es ist, wofür es ist, die einzeilige Lösung. Sage ihnen bei allem, was sie installieren müssen (ffmpeg, Node, Python, Chrome), den Befehl in die Terminal-App (cmd + Leertaste, „Terminal“ eingeben) einzufügen und „erledigt“ zu sagen. --install (faster-whisper, playwright, HyperFrames, speech model) nur nach ihrer Zustimmung: „Kann ich die kostenlosen Bearbeitungswerkzeuge installieren? Dauert etwa 5 Minuten, einmalig.“ Dann python3 "SK/scripts/style.py" check "STYLE" (ist der Stilordner vollständig) und python3 "SK/scripts/style.py" serve "STYLE" (startet den Seitenserver, falls er nicht läuft; notiere die URL). Nur beim ersten Mal: Frage, wo die Bearbeitungen gespeichert werden sollen (schlage den Ordner neben dem Stilordner vor, edits/) und speichere es: setup.py --save --style "STYLE" --edits "<ordner>".

2. Dateneingang (eine Nachricht)

Frage nur, was du nicht bereits hast:

• den Ordner mit den Rohclips (oft viele wiederholte Takes; du verwendest den LETZTEN sauberen Take jeder Zeile)
• worum es im Video geht und das Skript oder Notizen, falls vorhanden
• das Kommentar-Keyword für den Call-to-Action
• Ziellänge (schlage 25 bis 40 s vor)
• Musik: nur, wenn sie einen Titel nennen. Sonst keine (der Ersteller wählt die Musik selbst aus). Dann mkdir WORK und python3 "SK/scripts/style.py" resolve "STYLE" --out "WORK/style.json". Lies die STYLE.md vollständig: insbesondere Feedback from edits, Rejected und Kept, Neuestes zuerst. Das sind die eigenen Korrekturen des Erstellers aus vergangenen Bearbeitungen und überschreiben alles andere.

3. Takes, Schnitt, Wörter (~1 min pro 5 min Filmmaterial)

1. takes.py "WORK" "<clip>" ... --prompt "<Namen, die sie sagen werden>" listet jeden Versuch auf, Wiederholungen sind markiert. Lies WORK/takes/*.txt. Wähle den letzten vollständig sauberen Take jeder Zeile aus (überspringe Stocker; trimme einen schlechten Start, indem du den Einstiegspunkt in verschiebst). Schreibe WORK/edl.json (Format in der Verwendung von cut.py).
2. cut.py "WORK" --prompt "<Namen>": Rahmengenaue Segmente in WORK/hf/assets/v/, die Stimme bei -16 LUFS, saubere Kanten, und words.json / words.txt mit Reel-Zeiten. Betrachte progress/01-cut-takes-in-order.jpg.
3. Lies words.txt gegen das, was sie gemeint haben. Whisper hört Namen falsch: Korrigiere sie in words.json mit captions.py fix "WORK" "49=ArtCraft" (nur, um sie mit dem tatsächlich Gesagten in Einklang zu bringen). Teile ihnen den Schnitt in einer Zeile pro Beat und der Länge mit.

4. Zuerst das Storyboard (der Benutzer genehmigt, bevor etwas gerendert wird)

Folge references/storyboard.md: schreibe WORK/storyboard.json (ein Beat pro Idee: Wörter, Zeiten, Layout, Visual, Animation, Untertitel, Ton), erstelle ein Standbild pro Beat auf ihrem echten Filmmaterial mit der geplanten visuellen Komposition (echte Screenshots, echte App-Icons, JPGs), mit 2 bis 3 Alternativen (A/B/C) bei den 3 oder 4 Schlüsselbeats (Aufhänger, Hauptidee, Pointe, CTA). Dann storyboard.py page "WORK" --style "STYLE" und öffne http://localhost:<port>/storyboards/<slug>/ (open <url>). Sage: „Dein Storyboard ist offen. Wähle A, B oder C, wo es eine Wahl gibt, genehmige oder ändere jeden Beat, füge überall eine Notiz hinzu, drücke Submit und sag mir dann ‚fertig‘.“ Warte auf „fertig“. Dann storyboard.py review "WORK" --style "STYLE" integriert ihre Auswahlen und Notizen in storyboard.json. Baue nur die Beats neu, die sie geändert haben, und zeige sie erneut, bis alles genehmigt ist.

5. Variationen (optional, biete es einmal an: „Möchtest du 2 oder 3 Versionen des Aufhängers in Bewegung sehen, bevor ich das Ganze erstelle?“)

Für 2 oder 3 Schlüsselmomente: Baue den Schnitt weit genug, um sie abzudecken (Schritt 6), kopiere hf/index.html nach hf/index-<beat>-B.html mit diesem Beat neu gestaltet, dann render.py slice "WORK" <beat>-A <start> <end> und render.py slice "WORK" <beat>-B <start> <end> --index "WORK/hf/index-<beat>-B.html" (jeweils 2 bis 4 s, ~6 s Renderzeit). Füge "video": "variations/<name>.mp4" zu diesen Alternativen in storyboard.json hinzu, storyboard.py page "WORK" --style "STYLE" --variations, öffne .../storyboards/<slug>/variations.html, warte auf „fertig“, storyboard.py review ... --variations, behalte die Gewinner in index.html.

6. Bauen des Schnitts (der kreative Teil)

1. render.py new "WORK" --title "<video> v1": das pinned HyperFrames-Projekt mit den Farben, Schriftart, Untertitelschatten und dem Motion-Kit (engine/kit.js) im Stil in WORK/hf/.
2. Sammle echte Dinge: shoot.py web <url> <png> --mobile (Seiten nach vollständigem Laden), shoot.py icon "<App>" <png> (echte macOS-App-Icons), offizielle Logos von der Website des Tools, falls nicht anders verfügbar.
3. Schreibe WORK/hf/index.html Beat für Beat aus dem genehmigten Storyboard (Muster und Kit-API in references/engine.md), timing jede Visualisierung auf das Wort, zu dem es gehört, in words.txt. Gestalte jeden Beat neu; gib jeder visuellen Szene data-visual="<was es ist>" und data-layout="face|split|full".
4. Untertitel: captions.py make "WORK" --skip <a-b> (überspringe Momente, in denen der Bildschirmtext bereits die Wörter sagt), dann bearbeite WORK/caps.json von Hand: teile sie so auf, dass sie natürlich gelesen werden (2 bis 3 Wörter), setze top so, dass sie niemals auf dem Mund liegen, cls pro Beat, html für ein einzelnes Akzentwort. captions.py inject "WORK".
5. Ton: Schreibe WORK/cues.json (jeder Schnitt, jedes Panel, jedes Icon, jede Zeile, jedes Heldenwort erhält seinen Cue auf dem festgelegten Level; keine Doppeltreffer), füge die Musik nur hinzu, wenn sie einen Titel genannt haben, dann mix.py "WORK" (bringt den Mix auf -16 LUFS).
6. render.py check "WORK" (korrigiere jeden Fehler), render.py snap "WORK" <times> --name <beat> und SCHAU DIR die Frames an, die du geändert hast. Lege bei jedem Schritt ein nummeriertes Bild in WORK/progress/ ab (die Skripte erledigen den Großteil davon).

7. Rendern und selbst prüfen, bevor du etwas zeigst

render.py render "WORK" --out "WORK/<Video Name> - v1.mp4", dann qa.py "WORK" "<diese mp4>". Behebe jedes FEHLER. Dann schau dir tatsächlich jedes Bild an, das es auflistet (die 2-fps Kontaktabzüge und die Vollformat-Nahaufnahmen mit eingezeichneter sicherer Zone): Textüberfüllung, kleine oder hohe Visualisierungen mit leerem Raum, Untertitel auf dem Mund, dasselbe Layout zweimal, alles, was heraussticht, alles Schwarze, Zahlen/Namen, die nicht zu den Wörtern passen. Die automatisierten Prüfungen übersehen Dinge, die das Auge erfasst (der erste Test dieser Fähigkeit bestand die Prüfungen mit einem matschigen Heldenwort und leeren halben Karten). Ein Korrektur-Durchlauf, erneutes Rendern, erneutes Ausführen von qa.py, dann open "<mp4>". Teile ihnen in wenigen Zeilen mit: wo die Datei ist, wie lang sie ist, was Beat für Beat passiert, und alles, was du angenommen hast.

8. Feedback-Schleife (jedes Mal, wenn sie eine Anmerkung geben)

Korrigiere es, rendere erneut (ein erneutes Rendern dauert ~20 s), führe qa.py erneut aus, öffne es. UND schreibe es in ihren Stil, damit der nächste Schnitt es bereits weiß: python3 "SK/scripts/feedback.py" "STYLE" --video <slug> --rule "<das von nun an so machen>" (oder --rejected "<nie wieder>", --kept "<das geliebt>"). Verwende ihre Worte, eine Notiz pro Flag; eine Sache, die sie geliebt haben, ist genauso wichtig wie eine Sache, die sie gehasst haben. Es sichert STYLE.md zuerst und protokolliert es. Sage in einer Zeile, was du hinzugefügt hast. Wenn eine Notiz einen gesperrten Wert betrifft (den Shine, eine Zoom-Kurve, den Untertitelschatten), sage, dass es im Labor ihrer Stilseite lebt, und biete an, es zu öffnen, anstatt die Sperre stillschweigend zu überschreiben.

Zeiten (M-Serie Mac, 15 s fertiger Reel aus ~8 min Filmmaterial)

Takes ~1 min pro 5 min Filmmaterial · Schnitt + Wörter ~15 s · Storyboard-Standbilder ~2 min · Variations-Slice ~6 s pro Stück · Render ~20 s · QA ~30 s.