Communitygithub.com

Einführungs-Workflow (video-intake)

Verwandelt eine neue Video-Idee, ein Briefing oder eine Liste von Vorgaben in ein überprüfbares Konzept-Hauptbuch und stellt Fragen, bis jeder Parameter präzise ist, bevor ein Konzept, ein Prompt oder ein Build erstellt wird.

Was ist Einführungs-Workflow (video-intake)?

Dieser Skill ist das obligatorische Eintrittstor für jedes neue Videoprojekt. Seine Aufgabe ist es, aus einer vagen Idee, einem Briefing oder sogar einer Liste von spezifischen Anforderungen einen präzisen, überprüfbaren Aktionsplan zu erstellen, der als 'Konzept-Hauptbuch' (Concept Ledger) bezeichnet wird. Der Skill erzwingt eine strenge Planungsphase, bevor irgendein Prompt geschrieben oder eine Generation gestartet wird. Er interagiert mit dem Benutzer in einem iterativen Frage-und-Antwort-Prozess, um kritische Parameter wie Plattform, Länge, Ton, Qualität und Handlungsaufforderung zu klären. Kernstück ist das Hauptbuch, in dem jede konkrete Aussage des Benutzers als eine überprüfbare Zeile festgehalten wird. Sobald alle wichtigen Parameter gesperrt sind (locked) und der Benutzer einem endgültigen Prompt (PROMPT.md) zugestimmt hat, wird das Projekt an die nächste Phase übergeben. Voreingestellte Optionen werden empfohlen, aber der Benutzer hat immer die letzte Entscheidung. Der Skill ist sprachsensibel und bewahrt Hebräisch im Hauptbuch. Wichtig: Dieser Skill ist strikt auf die Planungsphase beschränkt und generiert keine Videos. Er verhindert Fehler durch ein System von 'Gates', die jeden Schritt auf Vollständigkeit und Korrektheit prüfen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/video-intake

In Ihrer bevorzugten KI fragen

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

Dokumentation

video-intake

Das Tor, das jedes neue Video zuerst passiert (Stufe wf-00). Ausgabe: ein wörtliches Aufnahmeprotokoll, ein Konzept-Hauptbuch mit einer messbaren Zeile pro konkretem Element, BRIEF.md und (falls der Benutzer kein Konzept festgelegt hat) drei Konzeptkarten. Es schreibt keinen Frame-für-Frame-PROMPT, keinen Code, keine Generierung.

Unveränderliche Regeln

  1. Aufnahme bis zur Präzision. Ohne Referenz fragen. Plattform, Länge, Ton, CTA, Struktur (Stille schneiden vs. neu aufbauen) und Qualitätsmaßstab werden nie geraten.
  2. Jede konkrete Sache, die der Benutzer geschrieben hat, wird zu einer Hauptbuchzeile mit einer ID, in den eigenen Worten des Benutzers (Hebräisch bleibt Hebräisch). Zusammengesetzte Behauptungen werden aufgeteilt ("Globus größer und Person höher" = 2 Zeilen).
  3. Keine Konzeptkarten, PROMPT-Struktur oder Build, bis die blockierenden Zeilen gesperrt sind: FMT, LEN, TON, BAR, CTA, FILE; plus STR und COLOR bei vorhandenem Filmmaterial; plus VAR, wenn mehr als eine Datei geliefert wird.
  4. PROMPT.md wird vom Benutzer vor der ersten Codezeile genehmigt, auch bei autonomen Läufen: der Agent entwirft, der Mensch genehmigt (Entscheidungsstandard Q6). Änderungsreihenfolge: Hauptbuch -> PROMPT -> Code.
  5. Keine Ausgaben hier. Aufnahme ist Planung. KI-Generierung benötigt paid-generation-gate; "nur planen" bedeutet keine Generierung. Unklare Rechte + Generierung geplant = blockiert.
  6. Gesperrte Zeilen werden nie überschrieben: eine Zeile hinzufügen und die alte durchstreichen (durchgestrichen von L<nn>, oder ~~alt~~ -> neu, Zeit in der Spezifikation).
  7. Frage nur, was unbekannt und wesentlich ist. Frage nicht nach Werkzeugen oder Ordnern; entscheide und begründe in einer Zeile.
  8. Fähigkeiten sind Verfahren, keine Berechtigung: Benutzer- und Projektlimits für Ausgaben und Installationen haben Vorrang. Nicht auf einem Modell getestet (Entscheidungsstandard Q4).

Ablauf

  1. Lies, was existiert: die Nachricht, die Anhänge und den GESAMTEN Quellbaum: python scripts/source_inventory.py <Quellordner> --write projects/<name>/_work/intake (schreibt source_ls.txt + probe.json; ein 4K-Kameraoriginal saß einst ungesehen neben einem Rohschnitt). Überprüfe projects/ auf ein Geschwisterprojekt mit derselben Quelle: frage "Neues Projekt oder Fortsetzung von X?". Verzweigungen (Referenz, eingefügter Prompt, "חדש לגמרי", "רק תכנן"): references/branches-and-mistakes.md.
  2. Protokolliere wörtlich in _work/intake/INTAKE_LOG.md: die Worte des Benutzers als einfache Zeilen, deine Fragen als Q:-Zeilen unter ## Runde N.
  3. Analysiere das Hauptbuch in den <ledger>-Block von hf/PROMPT.md (ein Entwurf ohne <structure>): IDs, dim, said, messbare spec, where / when, Akzeptanzprüfung, src U/R/D/A, Status (references/ledger-template.md).
  4. Frageschleife (references/question-bank.md): Runden von 3–4 Fragen, konkrete Optionen, erste = empfohlen; BAR in Runde 1. Gib nach jeder Runde נעול: ... | פתוח: ... aus und aktualisiere das Hauptbuch. "תמשיך" / "continue" = die empfohlenen Optionen übernehmen, als D markieren, in EINER Zeile mitteilen.
  5. Referenz vorhanden? Übergib sie an reference-style-transfer und frage, welcher Zeitbereich "der Stil" ist. Nicht vorhanden: weiter fragen; niemals einen Stil erfinden.
  6. Konzepte: Wenn der Benutzer keins festgelegt hat, drei Karten Bewährt / Gewagt / Wild, die sich im Konzept unterscheiden; empfehle eines (references/concept-cards-and-brief.md).
  7. BRIEF.md aus der Vorlage (agent-content/techniques/templates/BRIEF.md) mit den korrekten Fakten, führe ledger_check.py aus, übergib an den PROMPT-Autor, warte auf Genehmigung, protokolliere dann PROMPT_APPROVED <Datum> "<Worte>" in hf/CHANGELOG.md.

Die Frageschleife in Kürze

  • 3–4 Fragen pro Runde, mit der größten Auswirkung zuerst: FMT / LEN / STR / BAR, dann HOOK / TON / LOOK / MOT, dann TYPE / 3D / BROLL / BRAND, dann CAP / MUS / SFX / CTA, dann FILE / VAR / DUE.
  • Jede Option ist konkret (eine Zahl, ein Name, ein Hex, eine Datei); die erste Option ist die empfohlene, gekennzeichnet mit (מומלץ) / (recommended) mit einer Zeile Begründung. Visuelle Wahl: eine Vorschau oder ein choice-board hinzufügen, wenn 3+ Geschmacksentscheidungen anstehen.
  • Frage nie, was ls, ffprobe oder die Nachricht bereits beantwortet; frage nie nach Werkzeugen oder Ordnern.
  • Nach jeder Runde: נעול: L01 L02 ... | פתוח: HOOK LOOK ....
  • Keine Referenz gegeben bedeutet fragen; eine Referenz gegeben bedeutet sie analysieren und nur das fragen, was eine Referenz nicht beantworten kann (Länge, Seitenverhältnisse, Struktur, CTA, Dateiname, Balken, Musiklizenz, Frist).

Runde-1-Nachricht (Hebräisch / Englisch)

סבב 1 - ארבע שאלות, לכל אחת ברירת מחדל מומלצת:
1. פלטפורמה ויחס? (מומלץ: 9:16 ריילס/טיקטוק; מאסטר אחד, שאר היחסים בעיצוב מחדש)
2. כמה שניות בדיוק? (מומלץ: התוכן המלא בצילום; 45 במושן)
3. חיתוך שתיקות בלבד, או בנייה מחדש? (מומלץ: שתיקות בלבד, סדר טבעי, משפטים שלמים)
4. רמת איכות? (מומלץ: פרימיום - ביט גרפי כל 3-6 שניות, צבע מדוד)
Round 1 - four questions, each with a recommended default: 1. platform and ratio, 2. exact seconds, 3. silence cut only or rebuild, 4. quality bar.

Eine Hauptbuchzeile auf einen Blick

| L02 | TRN | "פילם ברן בשניה 1-2" | die Brenndatei des Benutzers, Vollbild, Bildschirmüberblendung | 1.00-2.00 s (f30-60) | Bildstreifen f28-62: Brenner sichtbar, Dateiname stimmt überein | U | gesperrt | Ein Anspruch pro Zeile; said wörtlich; spec messbar; ein zeitlicher said benötigt einen Bereich und eine Frame-Ebene-Prüfung (der Prüfer erzwingt beides).

Anzeichen dafür, dass die Aufnahme schief läuft

Länge oder Plattform erscheint ohne einen Benutzersatz dahinter; eine Konzeptkarte existiert, bevor FILE oder CTA gesperrt ist; eine D-Zeile, die der Benutzer nie gesehen hat; der Quellordner wurde nie aufgelistet; der PROMPT hat einen <structure>-Block und keine PROMPT_APPROVED-Zeile.

Prüfpunkte (Gates)

Zustände: pass | fail | blocked | n/a mit Begründung. Ein fehlendes Protokoll, leeres Hauptbuch, Zeitüberschreitung oder nicht lesbarer Ordner passiert nie.

PrüfpunktPrädikatNachweisWenn falschZuständigErneute Prüfung
G1 Hauptbuch-Vollständigkeitjede konkrete Klausel im Aufnahmeprotokoll hat eine Zeile; jedes Zitat einer U-Zeile ist im Protokoll; 0 erfundene Zeilenpython scripts/ledger_check.py hf/PROMPT.md --source _work/intake/INTAKE_LOG.md beendet mit 0 (Status PASS, Abdeckung checked)die fehlenden Zeilen hinzufügen oder eine Klausel mit Begründung --waive; das Protokoll niemals anpassenvideo-intakejede neue Benutzernachricht oder Hauptbuchänderung
G2 kein RatenFMT, LEN, TON, BAR, CTA, FILE (+STR, COLOR bei --footage; +VAR bei --variants) stammen jeweils von U/R/genehmigtem A oder von einer vom Benutzer gesehenen D-Zeile; <= 4 Fragen pro Rundedas gleiche Skript: blocking alle ok, kein too_many_questionsdie nächste Runde fragen; keine Konzepte schreibenvideo-intakeeine Antwort ändert eine blockierende Zeile
G3 Quellbaum gelesender gesamte Quellbaum wurde aufgelistet; Kamera-Original-Kandidaten gemeldet oder unknown_work/intake/source_ls.txt und probe.json existieren und werden zitierterneut ausführen; eine blocked-Listung bleibt blockiertvideo-intakeneue Dateien zur Quelle hinzugefügt
G4 ReferenzverzweigungReferenz vorhanden -> reference-style-transfer und der Stil-Zeitbereich aufgezeichnet; nicht vorhanden -> Schleife fortgesetztVerzweigungszeile im Aufnahmeprotokollkeinen Stil erfindenvideo-intakeBenutzer fügt eine Referenz hinzu
G5 drei Konzepte3 Karten, paarweise unterschiedlich in >= 2 von Haken-Gerät / Struktur / Bildsprache; jede listet die Hauptbuch-IDs auf, die sie befolgtdie Kartendas schwächste neu generierenvideo-intakeeine blockierende Zeile ändert sich
G6 RechteBRIEF.md hat einen ausgefüllten Abschnitt "Quelle und Rechte" (Filmmaterial-Eigentümer/Einwilligung, Musik/Stock-Lizenz pro Datei, Kunde vs. eigenes Konto)BRIEF.mdblockiert: keine kostenpflichtige Generierung, keine Werbenutzung von Lizenz: unbekannt (Entscheidungsstandard Q2)video-intakeein neues Asset erscheint
G7 Übergabeledger_check.py hf/PROMPT.md --source ... --prompt hf/PROMPT.md beendet mit 0 (jede ID >= 2x zitiert) und PROMPT_APPROVED ist in hf/CHANGELOG.mdSkriptausgabe + die ZeilePROMPT bleibt ein Entwurf; kein CodePROMPT-Autorjede Hauptbuch- oder PROMPT-Änderung

Ausgaben

_work/intake/{INTAKE_LOG.md, source_ls.txt, probe.json}, der <ledger>-Block in hf/PROMPT.md, hf/BRIEF.md, die ausgewählte Konzeptkarte, die Varianten-Zeilen (eine pro Datei), die OPEN:-Liste, das Hauptbuch-Prüf-JSON.

Abbruchbedingungen

  • Der Benutzer sagt "fang einfach an": empfohlene Standardeinstellungen als D übernehmen und mitteilen welche; trotzdem CTA, FILE und jedes blockierende Element fragen, das sie noch nicht gesehen haben.
  • Eine neue Anfrage widerspricht einer gesperrten Zeile: beide zeigen, fragen, welche gewinnt; niemals stillschweigend wählen.
  • Der Benutzer möchte die PROMPT-Genehmigung überspringen: die Abkürzung verweigern, einen kürzeren PROMPT anbieten, keinen übersprungenen.
  • Aufnahme durchläuft 4 Runden: gesperrt | offen zusammenfassen und den Benutzer bitten, den Rest mit einem "weiter" zu erledigen.

Referenzen und Skripte

  • references/ledger-template.md: laden beim Erstellen oder Bearbeiten des Hauptbuchs (Format, das der Prüfer parst, Dimensionscodes, Prüfungsarten, Beispiel).
  • references/question-bank.md: laden, wenn ein Feld fehlt oder vor dem Verfassen einer Runde (Hebräisch + Englisch, Optionen, Rundenplan).
  • references/branches-and-mistakes.md: laden, wenn die Eingabe eine Referenz, ein eingefügter Prompt, ein Geschwisterprojekt oder nach einem Prüfpunkt-Fehler vorliegt.
  • references/concept-cards-and-brief.md: laden beim Schreiben von Konzeptkarten, BRIEF.md, den Rechte-Fakten oder der Übergabe.
  • scripts/ledger_check.py, scripts/source_inventory.py: Standardbibliothek; jedes hat --self-check.
  • Geteilte Techniken (anderer Eigentümer): agent-content/techniques/concept-ledger.md (kanonische Hauptbuchregeln), agent-content/techniques/question-bank.md (vollständige hebräische Bank); Stufen-Spielbuch agent-content/playbooks/wf-00-intake.md.

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Verwandte Skills