Communitygithub.com

cut-as-code

Einstiegspunkt für videobasierte Arbeit mit cut-as-code. Eigene Routenführung und Projektstatus-Wiederherstellung. Das ausgewählte Blatt-Skill übernimmt redaktionelle Entscheidungen, Review-Gates, Skripte, Rendering-Details und Selbstprüfungen.

Was ist cut-as-code?

Dieses Skill dient als obligatorischer Einstiegspunkt für die videobezogene Arbeit mit cut-as-code. Es übernimmt ausschließlich die Routenführung (Routing) und die Wiederherstellung des Projektzustands. Die eigentlichen redaktionellen Entscheidungen, Review-Prozesse, Skripterstellung, Rendering-Details und Selbstprüfungen werden an das jeweils ausgewählte Blatt-Skill delegiert. Das Skill unterstützt Plattformen wie Claude Code und andere agentenbasierte Entwicklungsumgebungen. Es arbeitet mit einem klaren Zustandsautomaten: Anhand der ersten zutreffenden Bedingung wird der aktuelle Projektzustand geladen (z. B. aus `work/project.json`), und dann wird die Anfrage dem zuständigen Spezial-Skill zugewiesen (z. B. `/video-understand` für Analyse, `/video-cut` für Schnitt, `/video-color-grade` für Farbkorrektur). Mehrere Operationen werden in einer festgelegten Reihenfolge orchestriert: cut → color-grade → b-roll → captions → content-cards → graphic-motion. Gemeinsame Abhängigkeiten wie das Verständnis des Quellmaterials werden nur einmal ausgeführt. Das Skill vermeidet überflüssige Benutzerinteraktion, indem es nur bei fehlenden Eingaben, echter Routen-Mehrdeutigkeit oder erforderlichen redaktionellen Entscheidungen nachfragt. Fehlerhafte Projektzustände werden gemeldet, nicht überschrieben.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/WhiteTowerAI/cut-as-code/tree/main/skills/cut-as-code

In Ihrer bevorzugten KI fragen

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

Dokumentation

Cut as Code Einstiegspunkt

Verwenden Sie dies als obligatorischen Einstiegspunkt für videobasierte Arbeit mit cut-as-code. Eigene Routenführung und Projektstatus-Wiederherstellung nur. Das ausgewählte Blatt-Skill übernimmt redaktionelle Entscheidungen, Review-Gates, Skripte, Rendering-Details und Selbstprüfungen.

1. Vom Projektzustand starten

Wenden Sie die erste zutreffende Zeile an. Werten Sie keine niedrigeren Zeilen aus.

ZustandAktion
Der Benutzer nennt eine spezifische Operation an einem bestehenden ProjektUntersuchen Sie nur den für diese Operation benötigten Zustand, dann laden Sie das zugehörige Skill. Überspringen Sie die allgemeine Aufnahme.
Ein explizites Projekt-Root-Verzeichnis enthält work/project.jsonLesen Sie work/project.json, work/timeline.json und nur den Plan/Nachweis der ausgewählten Operation. Setzen Sie vom aufgezeichneten Zustand fort. Wenn der Besitzer nicht eindeutig ist, stellen Sie eine reine Routing-Frage.
Der Benutzer liefert eine Quelldatei oder URL, kein Projekt und ein klares LieferobjektLaden Sie /video-understand, um das Projekt und die gemeinsamen Nachweise zu initialisieren, und fahren Sie dann mit der angeforderten Operation fort.
Kein Projekt/Quelle oder kein beabsichtigtes Lieferobjekt identifizierbarStellen Sie eine kurze Frage, die das fehlende Projekt/Quelle und das gewünschte Ergebnis erfragt. Starten Sie noch kein Skill.

Das Projekt-Root-Verzeichnis muss explizit sein; behandeln Sie das Repository-Root-Verzeichnis niemals als Videoprojekt. Behandeln Sie work/project.json als das einzige gemeinsame Manifest. Bestimmen Sie den Fortschritt anhand des Operations-status, der revision, based_on, check und des Render-Zustands, nicht anhand der Verzeichnispräsenz. Führen Sie keine verifizierte Arbeit erneut aus. Wenn eine Abhängigkeit fehlt oder veraltet ist, vervollständigen Sie diese Abhängigkeit zuerst und setzen Sie dann die angeforderte Operation fort.

Routing ist schreibgeschützt. Reparieren, zurücksetzen, genehmigen, entfernen oder aktivieren Sie niemals eine Operation, während Sie entscheiden, wohin die Aufgabe gesendet werden soll.

2. Nach Lieferobjekt routen

Ordnen Sie die angeforderte Ausgabe zu, nicht ein beiläufig erwähntes Schlüsselwort.

Angefordertes ErgebnisZuständiges Skill oder Workflow
Untersuchung, Transkript, objektive Analyse, semantisches Verständnis oder Initialisierung eines neuen Projekts/video-understand
Straffen, kürzen, schwache Abschnitte entfernen oder einen ersten/rohen Schnitt erstellen/video-cut nach /video-understand
Farbe korrigieren, einen Look erstellen/auswählen oder einen LUT liefern/anwenden/video-color-grade; verwenden Sie dessen eigenständigen Pfad nur, wenn der Benutzer explizit keine Auslieferung über das Projektprotokoll möchte
Transkript-zeitgesteuerte visuelle Cutaways hinzufügen/video-add-b-roll nach /video-understand
Quellbasierte Motion Graphics oder animierte semantische Overlays hinzufügen/video-add-graphic-motion nach /video-understand
Titel, Lower Thirds, Statistiken, Zitate, Kapitel oder Handlungsaufforderungen hinzufügen/video-add-content-cards nach /video-understand
Untertitel, Bildunterschriften oder Karaoke-Untertitel hinzufügen/video-add-captions nach /video-understand
Das Original mit den tatsächlichen endgültigen Pixeln in der Quellenzeit vergleichen/video-edit-compare nachdem die verifizierte Hauptlieferung existiert
Kurzform-Bereiche auswählen, reviewen und planen/video-to-shorts nach /video-understand; dies vor den angeforderten Content Cards und Captions durchführen
Genehmigte horizontale oder vertikale Kurzform-Derivate finalisieren und extrahieren/video-to-shorts nachdem die verifizierte Hauptlieferung existiert
Eine bestehende Projektprotokoll-Lieferung kompilieren oder rendernVerwenden Sie build_render_plan.py und render_project.py aus /video-understand, nachdem jede ausgewählte aktive Operation ihr eigenes Gate bestanden hat

Eine allgemeine Anfrage wie „dieses Video bearbeiten" wählt nicht eindeutig /video-cut aus. Stellen Sie eine Routing-Frage, es sei denn, die gewünschte Ausgabe ist aus dem bestehenden Projektzustand oder der umgebenden Anfrage klar.

3. Multi-Operation-Anfragen orchestrieren

Frieren Sie nur die vom Benutzer angeforderten Operationen ein; machen Sie die Routentabelle niemals zu einem Standardpaket. Führen Sie die gemeinsame Verständnisvoraussetzung einmal aus. Führen Sie ausgewählte Hauptsequenz-Operationen in kanonischer Reihenfolge aus:

cut -> color-grade -> b-roll -> captions -> content-cards -> graphic-motion

Für eine Anfrage, die Shorts, Content Cards oder Captions umfasst, verwenden Sie diesen gestaffelten Ablauf:

/video-understand
-> /video-to-shorts Plan- und Kandidaten-Review nur
-> /video-add-captions
-> /video-add-content-cards
-> /video-add-graphic-motion
-> kompilieren und rendern der gemeinsamen Hauptlieferung einmal
-> /video-to-shorts finalisieren und genehmigte Derivate extrahieren

Schließen Sie jede angeforderte Timeline-ändernde Operation, wie z. B. /video-cut, vor der Shorts-Planung ab; eine geänderte work/timeline.json macht die Kandidatengenehmigung ungültig. Die Shorts-Planung schreibt gemeinsamen Plan/Review-Zustand und darf kein final.mp4 oder irgendetwas unter final/shorts/ erstellen. Captions, Content Cards und Graphic Motion fügen dann ihre eigenen gemeinsamen Pläne und Overlay-Beiträge in dieser relativen Reihenfolge hinzu. Die gleiche Reihenfolge gilt, wenn nur ein Paar ausgewählt ist: Captions zuerst, Content Cards als zweites, Graphic Motion zuletzt. Lesen Sie work/project.json vor jeder Übergabe erneut. Führen Sie Blatt-Skills nicht gleichzeitig aus, wenn sie work/project.json, work/timeline.json, einen Operationsplan oder gemeinsame Render-Artefakte schreiben können. Bauen und rendern Sie die Hauptlieferung einmal, nachdem alle ausgewählten aktiven Operationen validiert sind. Führen Sie /video-edit-compare und nur die Finalisierungs-/Extraktionsphase von /video-to-shorts gegen diese verifizierte Lieferung aus; Shorts bleiben außerhalb von sequences.main.operations.

Für /video-add-content-cards und /video-add-graphic-motion reservieren Sie das sichtbare Gesicht und die Kopf-Silhouette jeder primären oder vordergründigen Person, jedes Sprechers, Präsentators, Interviewpartners oder jeder semantisch wichtigen Person für den vollständigen Cue. Zufällige Hintergrundpersonen, die kein narrativer oder visueller Fokus sind, sind ausgenommen; schützen Sie unsichere Fälle. Wenn ein Overlay ein geschütztes Gesicht oder einen Kopf berührt, positionieren Sie es zuerst neu, dann skalieren oder gestalten Sie es um; überspringen Sie den Cue, wenn keine konforme Platzierung existiert.

Ein vollständig übersprungenes oder Zero-Cue-Ergebnis ist gültig, wenn das zugehörige Skill dies erlaubt. Erfinden Sie keine Füllarbeit, um eine Operation aktiv zu halten.

4. Übergeben und dann verlassen

Lesen Sie das vollständige SKILL.md des ausgewählten Skills und jedes erforderliche Sub-Skill, bevor Sie handeln. Für eine Operation übergeben Sie einmal und verlassen diesen Einstiegspunkt. Für einen angeforderten Multi-Operation-Durchlauf betreten Sie einen Besitzer nach dem anderen; nach dessen Selbstprüfung stellen Sie den Projektzustand wieder her und fahren mit der nächsten eingefrorenen Operation fort, ohne die Aufnahme erneut zu öffnen.

Bitten Sie den Benutzer nicht, eine bereits eindeutige Route zu genehmigen. Benutzerinteraktion gehört nur zu fehlenden Eingaben, echter Routing-Mehrdeutigkeit, Anmeldeinformationen oder den redaktionellen/Review-Entscheidungen, die das zugehörige Skill erfordert. Ersetzen Sie niemals eine Agent-Entscheidung für eine erforderliche menschliche Entscheidung, es sei denn, der Benutzer delegiert dies explizit.

Beispiel

Für „fahre mit diesem verstandenen und geschnittenen Projekt fort, indem ich Captions hinzufüge", lesen Sie die aktuellen Projekt- und Timeline-Revisionen und betreten Sie dann /video-add-captions. Transkribieren Sie nicht erneut, schneiden Sie nicht erneut und fragen Sie nicht, ob Captions der beabsichtigte Weg sind. Eine nicht zusammenhängende ausstehende Operation ändert die Route nicht, obwohl eine aktive, nicht verifizierte Operation das endgültige gemeinsame Rendern blockieren kann und vom Compiler gemeldet werden muss.

Fehlerregeln

  • Ungültiger Projektzustand: Melden Sie das genaue Validierungsproblem; initialisieren Sie niemals darüber hinweg.
  • Fehlendes Blatt-Skill oder fehlende Voraussetzung: Stoppen Sie und benennen Sie es; rekonstruieren Sie es nicht aus dem Gedächtnis.
  • Fehlender Quell-/Projektpfad: Fragen Sie danach in der einzelnen Routing-Frage.
  • Sich widersprechende angeforderte Ausgaben: Fragen Sie, welches Lieferobjekt den aktuellen Durchlauf besitzt.
  • Bestehende Benutzeränderungen oder Artefakte: Bewahren Sie diese auf und arbeiten Sie mit dem aufgezeichneten Zustand.

Individual skills in this repo

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

Verwandte Skills