Communitygithub.com

elkl111/reels-editing-lab-beta

Erstmaliges Einrichten des Reels-Editing-Labs. Installiert fehlende Komponenten, führt ein kurzes Markeninterview durch, lässt den Nutzer seinen Look auf eigenem Videomaterial auswählen und speichert diesen als sein Kit. Verwende es, wenn der Nutzer „Einrichtung“, „Los geht's“, „Onboarding“ sagt oder wenn brand/kit.txt noch nicht existiert (das Lab noch nicht eingerichtet ist).

Was ist reels-editing-lab-beta?

Diese Fähigkeit dient der erstmaligen Einrichtung des Reels-Editing-Labs. Sie automatisiert die Installation notwendiger Tools (wie Homebrew, ffmpeg, Python-Pakete, Playwright und ein Sprachmodell), führt ein kurzes Markeninterview durch (Energie, Marke, Vorlieben) und erstellt aus einem hochgeladenen Videoclip des Nutzers personalisierte Look-Vorschläge, die direkt auf dem Gesicht des Nutzers angezeigt werden. Der ausgewählte Look wird als individuelles Kit gespeichert und kann später auf jedes Reel angewendet werden. Die Einrichtung dauert etwa 10 Minuten und ist für nicht-technische Nutzer konzipiert – es werden keine komplexen Befehle eingegeben, außer der einmaligen Homebrew-Installation. Unterstützt werden klassische Looks (wie „Editorial“ oder „Playful“) sowie die Erstellung eines eigenen Marken-Looks aus einer Design-Datei, Farbcodes, Schriftarten oder Screenshots. Die Fähigkeit ist speziell für das Reels-Editing-Lab (ein Projekt zum Erstellen von Instagram- und TikTok-Reels) gedacht und wird über KI-Agenten wie Claude Code oder Codex ausgeführt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/setup

In Ihrer bevorzugten KI fragen

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

Dokumentation

Einrichtung

Der Nutzer hat das Lab zum ersten Mal geöffnet. Er ist nicht technisch versiert. Am Ende ist alles installiert, ein Look, den er an sich selbst gesehen hat, ausgewählt, und sein eigenes Kit gespeichert. Dann ist er bereit für sein erstes Reel.

Ton: warmherzig, kurz, Schritt für Schritt. Sag, was passiert, während der Nutzer wartet. Gib niemals die rohe Tool-Ausgabe weiter. Bitte den Nutzer nie, einen Befehl auszuführen, außer der einen Homebrew-Zeile, falls sie fehlt (siehe Schritt 1).

Beginne mit einer kurzen Nachricht:

Willkommen im Reels-Editing-Lab. Die Einrichtung dauert etwa 10 Minuten: Ich installiere ein paar Dinge, stelle dir 3 kurze Fragen, und du wählst deinen Look aus, indem du ihn auf deinem eigenen Video siehst. Los geht's.

1. Installieren (≈5 Minuten, hauptsächlich der Download des Sprachmodells)

Führe python3 tools/doctor.py aus. Es gibt eine Checkliste und DOCTOR=ok oder DOCTOR=missing:<Namen> aus. Behebe die fehlenden Elemente in dieser Reihenfolge, führe den Doktor am Ende erneut aus:

  1. mac / space: Wenn einer davon fehlschlägt, stoppe und erkläre freundlich (Mac mit Apple-Chip nötig; ca. 6 GB frei).
  2. homebrew: Du kannst es nicht für sie installieren, weil es ihr Mac-Passwort in einem echten Terminal benötigt. Erkläre in einem Satz warum, gib ihnen dann die exakte Zeile aus der Reparatur des Doktors und sage ihnen, sie sollen die Terminal-App öffnen (Cmd+Leertaste, Terminal eingeben), den Befehl einfügen, die Eingabetaste drücken, ihr Mac-Passwort eingeben (während der Eingabe wird nichts angezeigt; das ist normal) und den Anweisungen folgen. Am Ende gibt Homebrew zwei „Next Steps“-Zeilen aus, die mit echo und eval beginnen. Bitte sie, auch diese einzufügen. Warte, bis sie sagen, dass es fertig ist, und überprüfe dann erneut.
  3. apple-tools: Führe xcode-select --install aus. Ein Mac-Fenster erscheint. Sage ihnen, sie sollen auf Installieren klicken und Bescheid sagen, wenn es fertig ist (ein paar Minuten). Homebrew installiert diese normalerweise bereits, also überprüfe zuerst.
  4. ffmpeg: brew install ffmpeg (verwende /opt/homebrew/bin/brew, wenn brew noch nicht im Pfad ist).
  5. uv: curl -LsSf https://astral.sh/uv/install.sh | sh, verwende danach ~/.local/bin/uv, wenn uv noch nicht gefunden wird.
  6. python-tools: uv sync
  7. renderer: uv run playwright install chromium
  8. speech-model: Führe uv run tools/get_models.py im Hintergrund aus (2,3 GB). Es setzt von selbst fort, wenn die Verbindung abbricht. Starte es und fahre dann mit dem Interview fort, während es herunterlädt. Überprüfe vor Schritt 3 noch einmal, ob es fertig ist.

Während die Installation läuft, sage ihnen in einem Satz, wofür jedes Teil ist (die Beschreibungen des Doktors sind dafür geschrieben).

2. Markeninterview (3 Fragen, eine nach der anderen)

Stelle die Fragen konversationell, eine Frage pro Nachricht. Behalte ihre genauen Worte bei.

Frage nicht nach einem Namen, Slogan oder einem „Was machst du“-Label: Das Lab fügt standardmäßig keins hinzu (siehe die Fähigkeit „new-reel“, „label“).

  1. Energie. „Wie bist du vor der Kamera: ruhig und nachdenklich, warmherzig und gesprächig, oder voller Energie?“ Dies bestimmt, wie dynamisch der Schnitt ist (siehe Tabelle in Schritt 4).
  2. Marke. „Hast du eine Marken- oder Design-Datei, Markenfarben oder Schriftarten? Wirf deine Design-Datei (eine .md oder PDF) rein und ich baue deinen Look daraus. Oder füge Farbcodes ein, oder wirf 3–6 Screenshots von Reels, deren Look du liebst, in den inspiration-Ordner. Oder sag einfach ‚nein, zeig mir Optionen‘.“
  3. Nie. „Gibt es etwas, das du auf deinen Reels nie haben möchtest? Zum Beispiel Großbuchstaben, bestimmte Emojis, Soundeffekte, Wörter, die du nie sagen würdest.“

Speichere die Antworten in brand/profile.md:

# Profil
- Energie: warmherzig und gesprächig
- Marke: Farben #… / Schriftarten … / Screenshots in inspiration/ / keine
- Nie: …

Füge jedes „Nie“ als einzeilige Regel in brand/preferences.md hinzu.

3. Die Looks im eigenen Gesicht sehen

Frage: „Wirf jetzt einen Clip von dir, wie du in die Kamera sprichst, idealerweise 20 Sekunden oder länger, in diesen Chat oder in den inbox-Ordner. Es muss kein perfekter Take sein; er dient nur zum Ausprobieren der Looks.“

Wenn der Clip da ist (und das Sprachmodell fertig ist):

  1. uv run tools/transcribe.py "<clip>" --name welcome-sample

  2. Lese projects/welcome-sample/lines.md. Schreibe cut.json mit den ersten 3–5 sauberen Zeilen, etwa 12–20 Sekunden, unter Verwendung der Grobschnitt-Regeln von new-reel (letzter sauberer Take, keine Fehlstarts). Führe uv run tools/roughcut.py projects/welcome-sample --no-open und uv run tools/verify.py projects/welcome-sample aus und behebe alles, was markiert wird. Bitte sie nicht, diesen Schnitt zu überprüfen; es ist nur ein Beispiel.

  3. Schreibe build.json wie bei der new-reel-Fähigkeit: Ein Haken, der mit der Fähigkeit hooks aus dem tatsächlich Gesagten geschrieben wird (das ist ihr erster Eindruck vom Lab, also mach ihn gut), 1–2 Schlüsselwörter, 1 Zoom und eine Aussage zur stärksten Zeile. Füge 2–4 Pop-ups mit der Fähigkeit visuals hinzu (z. B. Chips für eine Liste, die sie erwähnen, oder ein Chat-Fenster, wenn sie über Prompting sprechen), damit sie sehen, was das Lab wirklich tut. Füge keinen Behind-Moment hinzu.

  4. Looks-Tabelle: uv run tools/build.py projects/welcome-sample --looks presets. Es öffnet ein Bild mit ihrem Clip in jedem Look, nebeneinander, in der Reihenfolge, die nach LOOKS= ausgegeben wird. Betrachte das Bild zuerst selbst (lies es) und überprüfe, ob der Text lesbar ist und nichts das Gesicht bedeckt.

  5. Stelle die Looks in einer kurzen Zeile vor, in der ausgegebenen Reihenfolge, unter Verwendung der description jedes Kits (packs/<name>/kit.json). Die obere Reihe zeigt den Haken und die Untertitel; die untere Reihe zeigt die Pop-ups. Sage dann deutlich, dass ein Look ein Ausgangspunkt und keine endgültige Wahl ist:

    Wähle den, dessen Gefühl dir am besten gefällt. Alles kann später geändert werden: „diesen, aber in Salbeigrün und Creme“, „verwende meine Farben: #…“, „eine weichere Schriftart“, „kein Pink“. Ich erstelle es auf deinem Clip neu, damit du es sehen kannst.

    Frage, welchen sie bewegt sehen möchten.

  6. Für jeden gewählten Look: uv run tools/build.py projects/welcome-sample --kit <Name> --out sample-<Name>. Es öffnet sich in QuickTime. Wenn sie zwei auswählen, erstelle beide und öffne sie nacheinander.

Wenn sie in Schritt 2 Markenfarben, Schriftarten oder Screenshots angegeben haben, biete auch an: „Oder ich kann einen Look aus deiner Marke machen.“ Siehe Schritt 5.

4. Ihr Kit speichern

Wenn sie sich entscheiden (z. B. „Editorial, aber in Salbeigrün und Creme“ oder „Verspielt, aber ruhiger“):

  1. Kopiere packs/<Voreinstellung>/kit.json nach packs/<vorname-klein>/kit.json. Ändere in der Kopie:

    • "name": ihr Name
    • "preset": false
    • "based_on": "<Voreinstellung>"
  2. Wende ihre Energie an:

    EnergieIntensitätZoom-Sprung / Punchsfx.volume_dbAussagen
    ruhig und nachdenklichclean1.04 / 1.08−17höchstens 1
    warmherzig und gesprächigsignature1.07 / 1.13−13höchstens 1–2
    voller Energiefull1.12 / 1.22−10bis zu 2

    Ändere rules.intensity, zoom, sfx.volume_db und den Wortlaut von rules.statement entsprechend.

    Sound-Set (sfx.palette):

    • ruhig: soft
    • warm: soft oder playful
    • voller Energie: punchy
    • Tech- oder KI-Themen: clicky in Betracht ziehen

    Erwähne einmal, dass sie jeden Sound in sfx/sound-menu.mp4 hören und Sets durch Fragen wechseln können („verwende die verspielten Sounds“). Falls sie „keine Soundeffekte“ gesagt haben, setze "sfx": {}. Falls sie keine Großbuchstaben wollten, setze style.caption_case, style.hook_case und style.statement_case auf "none".

  3. Wende ihre Farben an, entweder aus dem Interview oder aus dem Moment, in dem sie fragen („verwende stattdessen diese Farben“):

    • Aus Hex-Codes oder einfachen Namen: „salbeigrün“ oder „altrosa“ ist in Ordnung; wähle geschmackvolle Hex-Codes aus und teile sie ihnen mit.
    • Tausche die Werte in colors aus und behalte die Rollen bei: Helle Farben kommen auf Karten und Untertitel, dunkle auf Statement-Hintergründe und Tinte, helle auf Highlights und visuals.rotate.
    • Überprüfe den Kontrast: Text muss auf seinem Hintergrund lesbar sein.
    • Rendere die Looks-Tabelle neu für ihr Kit (--looks <ihr-Kit>), damit sie es vor dem vollständigen Beispiel sehen.
    • Schriftarten funktionieren genauso: Jede kostenlose Google-Schriftart (fonts.py bestätigt ihre Existenz).
  4. Schreibe den Ordnernamen des Kits in brand/kit.txt.

  5. Erstelle das Beispiel einmal mehr in ihrem Kit: uv run tools/build.py projects/welcome-sample --out sample-mine. Es öffnet sich in QuickTime. Frage: „Das ist dein Look. Möchtest du etwas ändern?“ Wende Änderungen an ihrem Kit an (nicht an der Voreinstellung) und erstelle es neu, bis sie zufrieden sind. Kleine Änderungen wie „kleinere Untertitel“, „weniger Gelb“ oder „keine Neigung“ sind einzeilige Bearbeitungen in kit.json.

5. Einen Look aus ihrer Marke erstellen (auf Anfrage)

Aus einer Design-Datei (der beste Weg)

Falls sie eine Marken- oder Design-Datei haben (eine .md, PDF oder Google Doc-Export, wie eine BRAND-DESIGN.md):

  1. Hole die Datei. Bitte sie, sie in den Chat zu ziehen oder in brand/ abzulegen, und speichere dann eine Kopie als brand/design.md (oder behalte die PDF) als Quelle der Wahrheit für ihren Look.

  2. Ordne sie ihrem Kit zu:

    In der Design-DateiIn kit.json
    Farbpalette (Hex-Codes und wofür jede ist)colors, plus roles: Hintergründe → hook_card und label_bg; Textfarbe → ink und hook_text; der „Statement“- oder dunkle Block → statement_bg; Highlight-Farben → highlight_blocks; Akzente → accent_pill, visuals.rotate
    Regeln wie „nie reines Schwarz oder Weiß“verwende ihre dunkelste Markenfarbe als Tinte
    Überschrift- und Anzeigeschriftartfonts.display / poster, ihre kursive Variante als fonts.italic, eine serifenlose für label und Untertitel
    Charakteristische Bewegungen (kursive Einmischung, Highlight-Blöcke hinter Wörtern, Neigung, Sticker, Großbuchstaben)moves und style (hook_case, statement_case, radius)
    Stimmung („ruhig“, „verspielt“, „luxuriös“)visuals.motion, visuals.density, sfx.palette
    Foto- oder Videostil (warm, stimmungsvoll, hell, filmisch)grade: contrast, saturation, brightness, warmth (−0,05 bis 0,05), vignette (0–0,5), legibility (dunkle Farbverläufe hinter Text, 0–0,5). Halte die Haut natürlich: keine Filmkörnung, keine starke Kompression.
    Symbole, grafische Elemente, Sticker, Schaltflächen (Linienstärke, abgerundet oder eckig, gefüllte Farbkacheln)visuals.icon_stroke (dünn 1,5 → fett 2,5), visuals.radius, visuals.card (solid / outline / glass), visuals.accent (Symbolkachel-Farbe), visuals.rotate (Chip- und Sticker-Farben)
  3. Bezahlte oder benutzerdefinierte Schriftarten: Suche nach den Schriftartdateien. Wenn sie welche haben, legen sie sie in fonts/private/ ab und das Kit verwendet "file". Falls nicht, wähle die nächstgelegene kostenlose Google-Schriftart: Stimme den Kontrast, die Breite (groß oder schmal?) und ob eine kursive Variante existiert, ab. Teile ihnen mit, was du ersetzt hast und warum. Zum Beispiel „deine bezahlte Serifenschrift → Instrument Serif: gleiches großes, kontrastreiches Gefühl, hat eine kursive Variante.“

  4. Zeige es: Rendere --looks <ihr-Kit> und erstelle sample-mine. Sage, welche Teile direkt aus ihrer Datei stammen und welche du interpretiert hast.

  5. Halte es synchron: Wenn sie die Design-Datei später aktualisieren („Ich habe meine Markenfarben geändert“), lies brand/design.md erneut und aktualisiere das Kit auf die gleiche Weise.

Aus Screenshots oder eingefügten Farben

Wenn sie ihren eigenen Look anstelle einer Voreinstellung möchten:

  1. Lese ihre Screenshots in inspiration/, ihren Markenleitfaden oder die von ihnen eingefügten Codes. Notiere:
    • Art: Serife oder serifenlos, wie fett, ob alles Großbuchstaben ist, ob eine kursive Variante gemischt wird
    • Untertitel-Behandlung: Umriss, Schatten oder Box; ganze Phrase oder Wort für Wort
    • Kartenformen und Radius
    • 4–6 Farben
    • wie vollgestopft es ist
  2. Beginne mit der nächsten Voreinstellung und ändere nur, was abweicht. Schriftarten müssen kostenlose Google-Schriftarten sein: Schreibe {"family": "<Google-Schriftart-Name>", "google": true, "weight": N} (füge "italic": true für eine kursive Variante hinzu). Bestätige jeden Download mit uv run tools/fonts.py "<Schriftartname>" --weight N. Wenn sie eine kostenpflichtige Schriftart besitzen, können sie die Datei in fonts/private/ ablegen und {"family": "...", "file": "fonts/private/<Datei>", "weight": N} verwenden.
  3. Kopiere nicht die exakten Schriftarten und Farben eines anderen Erstellers. Übernimm das Gefühl, nicht den markenrechtlich geschützten Look.
  4. Rendere --looks <ihr-Kit> zur Überprüfung, erstelle dann sample-mine wie in Schritt 4 und iteriere im Chat.

6. Abschluss

Erkläre in etwa 3 Zeilen:

  • ihr Look ist gespeichert und jedes Reel wird ihn automatisch verwenden

  • wie man ein Reel bearbeitet: Wirf einen Clip in inbox/ oder den Chat und sage „bearbeite dieses Reel“. Du schneidest es, sie überprüfen die Zeilen im Chat, und du erstellst es in ihrem Look.

  • dass Pop-up-Grafiken veranschaulichen, was sie sagen; „zeig mir die Grafiken“ spielt den Katalog aller 14 in ihrem Look ab

  • optionale Extras: Wirf 6 ihrer eigenen Reels in den Chat für den „Reels umkreisen dich“-Effekt und das Profilraster (tools/reels.py add); gib einmal ihre echten Instagram-Zahlen an (gespeichert in brand/instagram.json) für die Follow-Animation

  • dass sie nach einem Meme oder GIF zu einer beliebigen Zeile fragen können („der David Rose ‚ew‘-Meme hier“). Die Suche benötigt einen kostenlosen GIPHY-Key, den du beim ersten Mal besorgst; ihre eigenen GIF-Dateien funktionieren sofort

  • dass Farben und Schriftarten nie festgelegt sind: „verwende stattdessen diese Farben“ funktioniert bei jedem Reel, jederzeit

  • dass sie jederzeit alles ändern können, indem sie es einfach sagen („Untertitel kleiner“, „bei diesem keine Sounds“, „probier den lauten Look bei diesem Reel“)

  • dass fertige Reels im Ordner Fertige Reels landen

  • die Befehle: /new-reel für einen neuen Clip (starte für jedes Reel einen neuen Chat in diesem Ordner), /update für neue Versionen und /report-problem, falls etwas kaputt geht

Dann biete an: „Möchtest du den gesamten Clip, den du mir gerade gegeben hast, als dein erstes richtiges Reel bearbeiten?“ Falls ja, führe die new-reel-Fähigkeit darauf in diesem Chat aus.

Stil-Schalter für das Kit (für Anpassungen)

kit.json → "style":

  • caption_outline: px; 0 bedeutet nur ein Schatten
  • caption_case: "none" / "uppercase"
  • hook: "card" / "bare" (keine Karte, Text mit Umriss)
  • hook_size
  • hook_case
  • statement_case
  • label: "ticket" / "pill"
  • label_mark: das Symbol zwischen Name und Thema
  • radius
  • shadow / shadow_soft: rgba-Farben

"captions":

  • mode: "karaoke" (Wörter leuchten auf), "phrase" (ganze Phrase), "word" (ein großes Wort nach dem anderen)
  • size
  • max_words
  • position_y

"moves":

  • tilt_degrees
  • highlighter_blocks

Individual skills in this repo

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

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

elkl111/reels-editing-lab-beta

The visual director. Plans the pop-up explainer graphics (chips, numbers, chat windows, checklists, diagrams…) that illustrate what the speaker says, beat by beat, in their kit's style. Use in the new-reel build step, when the user asks for more or fewer graphics ("more pop-ups", "illustrate this part", "a checklist here"), or asks what graphics exist ("what can you add?", "show me the options").

Verwandte Skills