Communitygithub.com

Malik-rgb43/editing-workflow

Wandelt ein vom Benutzer gesendetes oder verlinktes Video (Datei, YouTube/TikTok/Instagram-URL) oder einen Ordner mit Clips in Messwerte (Schnitte, Rhythmus, Einzelbilddaten), Keyframe-Bögen, ein hebräisches Transkript und eine Audioanalyse (SFX, BPM, Tonart, Beats, Song-ID) um. Auslöser: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NICHT zum Schneiden oder Rendern (type skills), Anwenden eines Stils (reference-style-transfer) oder Untertitel für einen finalen Render (hebrew-captions-asr).

Was ist editing-workflow?

Diese Skill 'editing-workflow' eines Drittanbieters analysiert Videodateien oder Links zu Plattformen wie YouTube, TikTok oder Instagram sowie Ordner voller Clips. Sie erstellt eine vollständige, maschinenlesbare Aufschlüsselung: Messdaten pro Einzelbild, Keyframe-Bögen, eine Transkription (speziell für Hebräisch) und eine fundierte Audioanalyse inklusive Soundeffekten, BPM, Tonart, Beats und Song-Identifikation. Der Skill ist nicht für die Bearbeitung oder das Rendern von Videodateien gedacht, sondern dient der Analyse mittels eines externen Tools (private Skripte oder die portierte 'TOOLS_SPEC' Version) und erhebt Daten, die ein KI-Modell (wie Claude oder Codex) dann für eine detaillierte Beschreibung des Videos nutzt. Wichtige Sicherheitsmaßnahmen sind enthalten: Die Eingabedatei bleibt schreibgeschützt, die Ergebnisse werden nur in einem speziellen Analyse-Ordner gespeichert, und für vertrauliches Material sind keine kostenpflichtigen oder Cloud-Dienste erlaubt. Der Workflow umfasst das Lesen aller generierten Sheets und Audio-Bilder zur Überprüfung, die Korrektur automatischer Fehler (z. B. bei der Schnitterkennung, die bei 60 % der Anzeigen-Promovideos falsch liegt) und die Ausgabe eines strukturierten Berichts. Eine detaillierte Liste von Gates stellt sicher, dass die Analyse korrekt und fair abläuft und die Ergebnisse nicht als perfekte Messung überinterpretiert werden, wenn etwa nur eine Stichprobe genommen wurde.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

video-analysis

Wandelt ein Video in das um, was ein Modell lesen kann: eine numerische Messung jedes Einzelbildes, zeitgestempelte Kontaktbögen, ein Transkript, eine Audio-Zeitleiste und Spektrogramm-Bilder, gefolgt von einer daraus erstellten Aufschlüsselung. Es ist ein Workflow über das Analysetool, nicht das Tool selbst (das private Skript des Besitzers wird nicht mitgeliefert; der Port für Studierende folgt TOOLS_SPEC). Es bearbeitet, rendert oder wendet niemals einen Stil an.

Regeln, die über dem Rest dieser Datei stehen

  1. Eingaben sind schreibgeschützt. Vor und nachher wird ein Hash erstellt (input.sha256 = sha256_after); Ausgaben gehen nur unter analysis/<video>/. Lade nur die vom Benutzer angegebene URL herunter, benenne Quelle und Datei; es ist eine Referenzkopie, die nie weiterverteilt wird; ein Plattform-Wasserzeichen, Endcard und Jingle werden von Statistiken ausgeschlossen und aufgelistet.
  2. Der Deckungsgrad wird zuerst genannt. Jeder Bericht beginnt mit einem Deckungsblock: vollständig vs. Stichprobe, dekodierte Einzelbilder von erwarteten, was ausgeschlossen wurde, was NICHT ausgeführt wurde. Eine Stichprobe wird niemals als vollständige Abdeckung dargestellt. Ein Durchlauf mit Stichproben darf keine Schnittanzahlen oder Rhythmusangaben als gemessene Tatsache zitieren.
  3. Führe das Tool aus; nimm niemals mit ffmpeg eine manuelle Stichprobe. Wenn das Tool fehlt, gib blocked: tool_missing an und frage nach; ein manueller Fallback ist nur als explizit gekennzeichneter sampled-Durchlauf ohne Zählungen erlaubt.
  4. Lies, bevor du schreibst: Sieh dir JEDES Blatt und JEDES Audiobild an; zoome 3- bis 6-mal; entscheide über jeden check-Schnittpunkt anhand der Einzelbilder; korrigiere falsche Zählungen und gib dies an.
  5. Lokal, kostenlos, privat. Keine kostenpflichtige Videoanalyse-API, kein Hochladen des Videos, seiner Einzelbilder oder seines Tons, keine Song-Identifikation aus der Ferne für private Materialien, ohne einen datierten Kostenvoranschlag und vorherige Genehmigung (paid-generation-gate). Hebräische Sprache wird auf he erzwungen; vertraue niemals einem einzigen ASR-Durchlauf bei Namen, Marken und Zahlen.
  6. Eine Song-Übereinstimmung ist keine Lizenz. Melde „identifiziert als X, Synchronisationserlaubnis nicht bestätigt“ oder „nicht identifiziert“; erfinde niemals einen Titel. AudioSet-ähnliche Labels sind Schätzungen („wahrscheinlich ein Whoosh“); Tempo und Tonart sind Schätzungen mit halber/doppelter Geschwindigkeit, die überprüft werden.
  7. Nur eine schwere Aufgabe gleichzeitig unter render_lock; alles über etwa 2 Minuten läuft im Hintergrund mit einem Log und einer ETA; keine Laufzeitgarantie (Batch des Besitzers: 9–23 Min pro Video unter Last, maschinenabhängig). Skills sind Workflow, keine Erlaubnis: Benutzer- und Projekteinschränkungen überschreiben diese Datei.

Tool-Schnittstelle, die dieser Skill erwartet (TOOLS_SPEC video-analysis; überprüfen mit --help)

python tools/analyze.py <video|URL|folder> --out analysis/<video> [--detail quick|standard|full]
       [--asr auto|always|never] [--no-song-id] [--no-audio-ai] [--check]
python tools/frames.py <video> --at <t> --pad 0.25 --out analysis/<video>     # jedes Einzelbild eines kurzen Fensters

Ausgabevertrag (references/output-contract.md): analysis/<video>/{measurements.json, frames.csv, sheets/ (index.json + images), transcript.json, audio.json} + breakdown.md.

Workflow

#SchrittArtefakt
0Frage nur, was den Durchlauf ändert: ganze Analyse oder eine einzelne Frage (Schnitte / Transkript / Song)? Vertrauliches Material (private)? Welche Sprache für die Analyse? Bei einem Ordner: liste ihn zuerst auf; überschreibe niemals eine frühere Analysescope line
1Preflight (analyze --check / doctor): Erfasse OS, ffmpeg, erkannte ASR-Route (CPU / Vulkan / CUDA / MLX; none bei Nicht-Erkennung), das Vulkan-Umgebungsflag; keine Route = blocked nur für das Transkriptenvironment-Block
2Führe im Hintergrund unter dem Lock aus. --detail: quick für Korpus/lange Vorträge, standard als Standard, full für Bewegtgrafiken, sehr schnelle Schnitte oder eine Referenz zum Übertragen (references/thresholds.md). Mehrere Videos: ein Batch, dann ein Agent pro Video (nur sein Ordner, breakdown.md als Ausgabe, Frist, Antwort <= 10 Zeilen)Analyse-Ordner
3python scripts/validate_analysis.py analysis/<video> --stage producedPASS oder die fehlschlagenden Komponenten
4Lies: alle Blätter, alle Audiobilder; zoome nur bei auffälligen Geräten; löse check-Punkte auf; korrigiere die Zählung (pacing.override + review.corrections); überprüfe Tempo halb/doppeltreview-Block
5python scripts/validate_analysis.py analysis/<video> --video <source>; exit 0 erforderlich, um Zahlen als Fakten darzustellenValidierungsbericht
6Schreibe breakdown.md in der Sprache des Benutzers gemäß references/reading-and-breakdown.md (zuerst Deckungsgrad, 7 Abschnitte, Unsicherheiten zuletzt)breakdown.md
7Melde: Dateipfad, 5–10 Zeilen, die Korrekturen, was nicht festgestellt werden konnte; biete den nächsten Skill (reference-style-transfer, ein type skill) an, anstatt ihn auszuführenNachricht

Gates

Zustände sind pass | fail | blocked | n/a mit einem Grund. Ein Timeout, eine leere Stichprobe oder eine fehlende Eingabe ist blocked, niemals pass. Ein erfolgreicher Tool-Aufruf ist Ausführungsnachweis; eingesehene Blätter sind Erscheinungsnachweis.

GatePrädikatNachweisWenn falschVerantwortlichErneute Prüfung wenn
G1 MaschinenprofilASR-Route erkannt und aufgezeichnet; Vulkan-Route zeichnet GGML_VK_DISABLE_COOPMAT auf (Besitzers AMD-Treiber benötigt =1; andere Treiber ungetestet)measurements.environment von doctor/--checkFalle auf die CPU-Route zurück und sage es; nimm niemals eine GPU andieser Skill + doctorneue Maschine, Treiber oder Modell
G2 Vertrag gültigalle fünf Komponenten bestehen oder sind n/a mit Grundvalidate_analysis.py exit 0 (--video angegeben)repariere oder führe die Komponente erneut aus; melde INSUFFICIENT mit dem fehlenden Teilvalidate_analysis.pyjeder erneute Durchlauf oder manuelle Bearbeitung
G3 DeckungsangabeBericht beginnt mit Modus, dekodierte/erwartete Einzelbilder, Ausschlüsse, nicht ausgeführte Liste, claims_not_allowederster Block von breakdown.mdfüge es hinzu; stufe Behauptungen auf „Stichprobe“ herabdieser Skilljeder Bericht
G4 Schnitterkennungs-Regressionjede Änderung eines Detektor-Schwellwerts behält F1 >= Basislinie des gelabelten Satzes (historisch 0,89 des Besitzers = P 0,87 / R 0,91 bei 20 handgeprüften Anzeigen, 339 Schnittpunkte, privat, nicht reproduziert; bekannte Schwachstelle: kinetische Typografie und Stücke mit durchgehender Kamera)cut_regression.py --pair ... --min-f1 0.89 exit 0 mit >= 100 Wahrheitspunktenmache die Schwellwertänderung rückgängigcut_regression.pyjede Detektoränderung; niemals nach Augenmaß
G5 Eingaben unberührtQuell-Hash vorher und nachher identischvalidate_analysis.py --videostelle die Datei aus dem Original wieder her, führe erneut ausvalidate_analysis.pyjeder Durchlauf
G6 Lies vor dem Schreibenjedes Keyframe/Übersichtsblatt und Audiobild angesehen; jeder check-Punkt aufgelöst; Zählungen anhand der Einzelbilder verifiziertreview-Block vollständig (Phase reviewed)gehe zurück und sieh sie andieser Skilljede Analyse
G7 Datenschutz und Rechteprivate Eingabe: keine Song-Identifikation aus der Ferne, keine Cloud-ASR, kein Frame-Upload; Übereinstimmung = keine Lizenzsong_id.status, asr.routelösche das Auszug-Log, führe lokal erneut ausdieser Skilljeder Durchlauf

Zahlen und Grenzen, die mit ihrem Gültigkeitsbereich zu zitieren sind

  • Schnitterkennung: nur die Abstimmung des Besitzers (G4); die automatische Schnittanzahl war bei etwa 60 % der Anzeigen-Promovideos falsch, bis sie anhand der Einzelbilder verifiziert wurde; ein Beispiel mit kinetischer Typografie ergab automatisch 108 Schnitte/Minute gegenüber 42 aus den Bögen.
  • ASR (Maschine des Besitzers, E08, ein Durchlauf, gelesene Sprache): Vulkan 5,82 Audio-Sekunden pro Wand-Sekunde, CPU CT2 int8 0,84, WER 17,7–19,4 %: references/volatile-facts.md (datiert; läuft am 31.12.2026 ab).
  • Audioanalyse läuft nur echt: Beats/BPM/Tonart benötigen >= 3 s Musik; gesungener Gesang benötigt den No-VAD-Lyrics-Durchlauf (nur sichere Segmente, markiert als „SUNG LYRICS“).

Referenzen (laden bei)

  • references/output-contract.md – Schreiben, Portieren oder Debuggen einer Ausgabedatei; Lesen eines Validierungsberichts.
  • references/thresholds.md – Abstimmung oder Portierung des Detektors, Wahl von --detail, Erklären einer falschen Zählung.
  • references/reading-and-breakdown.md – vor dem Lesen von Bögen und vor dem Schreiben der Analyse.
  • references/volatile-facts.md – vor dem Zitieren einer Geschwindigkeit, WER, Preis, Lizenz oder Tool-Fakt (datiertes Modul).
  • agent-content/references/asr-routes.md (kanonische ASR-Routen, Eigentum anderweitig) und hebrew-captions-asr (Untertitel-qualität Transkripte); reference-style-transfer konsumiert die Ordner dieses Skills.
  • Skripte: scripts/validate_analysis.py (Vertragsprüfung, --self-check), scripts/cut_regression.py (F1-Gate, --self-check); beide schlagen standardmäßig fehl (exit 0 / 1 / 2).

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 new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

Verwandte Skills