Communitygithub.com

Malik-rgb43/edit-motion-graphics

Ein professioneller Workflow zum Entwerfen, Bauen und Überprüfen von Bewegtgrafiken (Motion Graphics) mit HyperFrames und GSAP – für Produkt-Launches, Feature-Ankündigungen, kinetische Typografie, Logo-Animationen, UI-Erklärvideos und animierte Screenshots.

Was ist edit-motion-graphics?

Diese Skill-Anleitung definiert einen detaillierten, agentengesteuerten Workflow für die Erstellung fertiger Bewegtgrafiken (MP4) unter Verwendung von HyperFrames HTML und einer angehaltenen GSAP-Timeline. Sie richtet sich an KI-Agenten wie Claude Code, Cursor oder Codex und legt strikte, nicht verhandelbare Regeln fest: Kein Code ohne ein vom Menschen genehmigtes PROMPT.md auf Frame-Ebene, keine kostenpflichtigen API-Aufrufe oder KI-gestützten Renderings (diese werden an einen separaten 'paid-generation-gate' weitergeleitet) und eine verbindliche Überprüfungsreihenfolge vom Studio-Vorschaubild bis zur finalen MP4 mit frame- und bewegungsgenauer Qualitätssicherung. Der Workflow umfasst die Aufnahme einer Aufgabenbeschreibung (Brief/Ledger), die Erstellung eines Frame-Vorlagendokuments (PROMPT.md) und eines Designspezifikationsdokuments (DESIGN.md), die Quellenbeschaffung, die agentenbasierte Code-Erstellung und mehrstufige Qualitätsprüfungen, die ausführlich dokumentiert werden. Der Anhang enthält außerdem eine Tabelle mit 'Registern' (Launch, Kinetic, Logo, Explainer, Calm), die jeweils die Bildrate, Ereignisdichte, Kamerabewegung und Tonanforderungen festlegen, sowie Leitlinien für die Integration von 3D-Elementen pro Beat (Blender, Three.js, 2.5D oder keine). Fehlerzustände werden explizit als 'blocked', 'fail' oder 'pass' definiert, sodass der Agent automatisiert fundierte Entscheidungen über den nächsten Schritt treffen kann.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht edit-motion-graphics?

Verantwortlicher für ein fertiges Bewegtgrafiken-Stück (MP4), erstellt als HyperFrames HTML und eine pausierte GSAP-Timeline. Das Frame-Ebenen-PROMPT.md ist das eigentliche Produkt; der Code rendert es nur.

Nicht verhandelbare Regeln (zuerst lesen)

  1. Kein Code vor einem genehmigten Frame-Ebenen-PROMPT.md – auch bei autonomen Ausführungen: Der Agent entwirft, ein Mensch genehmigt (Entscheidungsstandard Q6). Die Genehmigung ist eine protokollierte Zeile APPROVAL: <wer> <datum> in der Datei. Die Änderungsreihenfolge ist immer Ledger → PROMPT.md → Code.
  2. Keine Ausgaben hier. KI-3D, KI-Standbilder oder andere kostenpflichtige Generierungen laufen über paid-generation-gate; dieser Skill tätigt keine kostenpflichtigen Aufrufe. Ein Katalogeintrag ist kein Kontozugriff.
  3. Überprüfungsreihenfolge: Studio-Vorschau → hf_segment-Bereiche → EIN vollständiger Render pro Korrekturrunde → Every-Frame-Qualitätssicherung beim finalen Render. Ein schwerer Job gleichzeitig (render_lock). Notizen bündeln; diagnostizieren, während der Benutzer noch schreibt, aber nicht rendern.
  4. Harte Fallstricke: kein dir="rtl" auf dem HyperFrames-Root (RTL nur auf Textelementen, lang="he" auf <html>); Schriftarten aus Dateien (@font-face in hf/fonts/); hyperframes snapshot --describe false, maximal 5 Zeitstempel pro Aufruf; ASCII-Work-Root (new_project).
  5. Bei Fehler schließen: Ein Gate, das nicht ausgeführt werden kann, ist blocked (not_run), niemals pass. Ein Timeout, ein leeres Sample oder ein fehlender Render gilt niemals als bestanden. Ein erfolgreicher Tool-Aufruf ist Ausführungsnachweis; ein betrachteter Render ist Erscheinungsnachweis; ein Standbild kann keine Bewegung beweisen.
  6. Gesetz vs. Geschmack: Regeln 1–5 sind Gesetz. Die unten als Studio-Stil markierten Punkte (keine Untertitel standardmäßig, Verbotsliste, "kein Pink", Higgsfield-Grammatik, 21st-First) sind der Geschmack des Verantwortlichen, mit Begründung vermittelt; ein abweichender Brief gewinnt beim Geschmack, niemals bei den Gates.
  7. Zahlen tragen ihre fps (30, sofern der Brief nichts anderes sagt) und gemessene Zeitangaben tragen die Maschine (des Verantwortlichen: Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB). NVIDIA/Apple-Zeiten sind nicht gemessen. Projekte, die Ausgaben, Installationen oder Veröffentlichungen einschränken, überschreiben diesen Skill.

Eingaben → Ausgaben

Eingabe: Brief/Ledger (von video-intake), Brand-Kit, UI-Screenshots oder -Komponenten, Musik/VO. Ausgabe: hf/PROMPT.md (Frame-Ebene), hf/DESIGN.md (eine festgelegte Palette + Typografie + Bewegungs-Tokens), hf/cues.js (einheitliche Timing-Quelle für Bild und Ton), hf/SOURCES.md, die Komposition, mix.wav, die finale MP4, QA-Berichte. Übergaben: Notizen → revision-round; andere Formate → multi-video-variants (vollständiges Neu-Layout, niemals ein Zuschnitt); Liefer-Gate → render-qa-deliver; eine Referenz gegeben → zuerst reference-style-transfer (keine Referenz → frage, welcher Zeitbereich "der Stil" ist).

Ablauf

  1. Registrieren + Aufnahme. Ein Register wählen (launch | kinetic | logo | explainer | calm) und Länge, Seitenverhältnisse, VO, Musik, Liefernamen festlegen (references/launch-register-and-pace.md). Ein 30 s dichter Launch fühlte sich x1,7 zu schnell an; die genehmigte Länge war 45 s: zuerst die Länge entscheiden.
  2. PROMPT.md + DESIGN.md entwerfen (6 Blöcke; die Tabellen für Kamera, Naht und Ereignis; Beat-Karten für jegliches 3D). python scripts/motion_spec_check.py hf/PROMPT.md --register <r> ausführen; beheben; Genehmigung einholen.
  3. Quellen erschließen (references/ui-sources-and-port.md): Katalog → hf-blocks → shadcn-Registries (Standard) → 21st.dev nur mit Konto → handgebaut; 3D pro Beat entscheiden (references/three-d-decision.md).
  4. Bauen ein index.html + cues.js; portierte Komponenten suchsicher neu erstellt. Dann hf_preflight --strict, python scripts/seek_safe_scan.py hf/, python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <3D-Render>].
  5. Visuell genehmigen: vier Standbilder + ein Schnappschuss jeder Naht + sheet Kontaktbogen; Studio-Vorschau; Notizen bündeln.
  6. Ton (references/sound-and-captions.md): hf_mix --report; Brand-Sound bei jedem Brand-Ereignis; muxen und die finale Datei messen.
  7. Ein vollständiger Render unter der Sperre mit Vorab-ETA; frame_qa, motion_qa, hf_deliver; Bewertung mit agent-content/benchmarks/motion-graphics.rubric.md durch einen separaten Prüfer; die Datei präsentieren, nummerierte Änderungen, das abgehakte Ledger und die ehrlichen Lücken.

Register auf einen Blick (Details: references/launch-register-and-pace.md)

RegisterNeuer ScreenEreigniskadenzKameraTon
launchalle 2–6 s, >= 2 Tiefenebenen<= 0,5–1 s; 45–110/min per Handzählungstoppt nie (Drift 2–4 %/s, Push-Ins 8–15 %)Musik ist das SFX; Brand-Sound bei jedem Brand-Ereignis; Ausklingen
kineticalle 1–3 sbis zu ~200/min (Wortwechsel zählen)Die Schrift ist die KameraSchlagwort landet 0..+7 f nach dem Sprechen
logoeine Idee, 3–8 sErgebnis sichtbar nach 0,4–0,75 seine Bewegung + EinpendelnBrand-Sound bei der Enthüllung; 3-Schritt-Ende
explainerpro Idee, 3–6 s30–110/minzielgerichtet, auf das erklärte ObjektVO-geführt; SFX nur bei sichtbarer Änderung
calmHalten erlaubtspärlich ist in Ordnunglangsam oder fixiertein gleichmäßiges Bett + dezentes Foley; keine Steigerungen/Abfälle

Pro-Beat-3D in fünf Zeilen

Pro Beat entscheiden, den Grund in PROMPT.md notieren: Blender für echte Geometrie / Heldenmaterial auf Bildschirm > 2 s (zuerst EEVEE; gemessen 1,2–2,25 s/Frame bei 384–640 px, +1–1,5 min pro Launch); Three.js für datengetriebene, instanziierte, 3D-UI-mit-Live-Text, editierbare oder exakt-hex Beats, nach einem 1 s hf_segment AMD-Gate; KI-3D nur hinter paid-generation-gate und einer Lizenzprüfung; 2.5D (depth_25d, Depth Anything V2 Small, 8,1–9,9 s pro 2 s Clip) für ein Standbild, das eine kleine Bewegung braucht; keine für UI/Message-Beats. Ein 3D-Objekt verdeckt niemals Informationen und reagiert auf das Wort.

"Langweilig / sieht aus wie KI / statisch" an einem Zeitstempel

Das Beat-Konzept ersetzen, nicht polieren. Aus dem Menü wählen: eine Sprachkugel, angetrieben durch das echte VO-Spektrum; ein datengetriebener Aufbau (Balken, Zähler, Routenglobus); die im Code wieder aufgebaute und als Objekt gefilmte UI (Perspektive, Schärfentiefe, 150–300 % Vergrößerung); ein Shared-Element-Morph, der Inhalt trägt; ein Zahlen- oder Wortwechsel an Ort und Stelle; ein 3D-Held, der auf dem Schlüsselwort landet. Niemals eine kleine Ecken-„Feature-Pille“, ein flacher Screenshot mit kleinem Push-In oder ein Punkt auf Schwarz. Den Hinweis zur Verbotszeile hinzufügen und bei jedem Auftreten beheben (globale Regel, wenn es sich wiederholt).

Zeitbudget (modelliert oder auf der Maschine des Verantwortlichen gemessen; keine Studentenmessungen)

Ziel: Erster vorzeigbarer Entwurf eines 30–45 s Launches in etwa 3–4 h mit 1–2 Korrekturrunden (der erste echte Launch brauchte 10 Entwürfe, 7 Prüferrunden, 4 Runden mit Notizen des Verantwortlichen); genau EIN vollständiger Render pro Runde. Render-Referenz (HyperFrames 0.8.98, E11, schwer 40 s / 1200 f): 1 Worker 132,6 s, 4 Worker 92,8 s, 8 Worker 88,1 s; Browser-GPU -12 %; Capture ist der Engpass (CPU-Auslastung nur 2–3 von 16 logischen Kernen). Frühere Premium-Render: 8–14 min typisch, 4–21 beobachtet (0.8.79–0.8.93). Vor einem Job über 3 Minuten immer eine Einheit benchmarken und eine ETA-Zeile posten.

Gates

Zustände: pass | fail | blocked | n/a, immer mit einem Grund.

GatePrädikatNachweisWenn falschVerantwortlichErneute Prüfung
G0 AufnahmeRegister, Länge, Seitenverhältnisse, Liefername, VO/Musik-Quelle, Referenzantwort aufgezeichnethf/BRIEF.mdfragen (3–4 Fragen pro Runde); blockedvideo-intakeBrief-Änderungen
G1 Frame-Ebenen-Spezifikation6 Blöcke; jeder Beat hat Frames + px + Easing + Sound + Übergang; Verbotszeile; Hex-Palette; APPROVAL:-Zeilemotion_spec_check.py Exit 0 (2 = Genehmigung fehlt = blocked)Spezifikation beheben; vor dem Code stoppendieser Skill + menschlicher Genehmigerjede Neutiming oder neuer Beat
G2 Sauber & GlattEIN Spline pro Szene, jede Bewegung >= 1,2 s, Kehren >= 1 s und <= 1,3x, Text im Frame an jedem Schlüssel; Nähte Austritt = Eintritt, Held persistiert, keine wiederholte Technik, kein AusblendenTabellen in PROMPT + Prüfer; motion_qa 0 Ruckelbereiche im RenderNeutiming / Neupfad; das Beat-Konzept ersetzen statt polierendieser Skilljede Kamera- oder Nahtänderung
G3 Dichtepro Register: Launch = neuer Screen alle 2–6 s, Ereignislücken <= 0,7 s (deklarierte Atempausen ausgenommen), 45–110 Ereignisse/min (Handzählung)Ereignistabelle + 3 Frame-Stichproben pro SzeneBeats hinzufügen oder ersetzen; lange Bewegungen x1,6 dehnen statt stopfendieser Skillnach jedem Neutiming
G4 3D pro Beatjeder 3D-Beat hat eine Karte: Route (Blender / Three.js / KI-3D / 2.5D / keine), ein Satz Begründung, ETA, Gate-Nachweis, LizenzBeat-Karten-Tabelle; Three.js-Zeilen: ein 1 s hf_segment Frame, der nicht leer istneu entscheiden; KI-3D-Zeilen brauchen paid-generation-gatedieser Skillneuer Beat oder Asset
G5 Paletten-Sperreeine Palettentabelle; jedes Hex in Quellen und jeder 3D-Render darinpalette_audit.py Exit 0 (+ --png)neu einfärben / neu rendern; blocked wenn keine Tabelledieser Skillneues Asset, neuer Render, Farbnotiz
G6 UI-Quellenbeschaffungjeder UI/Effekt-Beat hat eine SOURCES.md-Zeile (Quelle, Lizenz, Version, Datum) und einen suchsicheren Port; kein npx shadcn add in einem Projekt; keine 21st-Vorschau/Medien kopiertSOURCES.md + ScanQuelle tauschen oder mit Begründung handbauendieser Skillneue Komponente
G7 Suchsicherheithf_preflight --strict 0 Fehler; seek_safe_scan.py 0 Fehler; Schnappschüsse zu nicht sequenziellen Zeiten stimmen übereinBerichte + Schnappschuss-Paarbeheben; niemals durch Unterdrückung ohne Grund „beheben“dieser Skillnach jedem Code-Patch
G8 TonBrand-Sound bei jedem Brand-Ereignis; SFX unter VO innerhalb von -18..-26 dB und 1–3 f vor Bild; Musik klingt aus; Finaldatei -14 LUFS +-0,5, TP <= -1 (Haus-Preset v1, Q5)hf_mix --report, hf_deliver prüft an der ENDGÜLTIGEN Dateineu mischen und remuxen (kein Neu-Render)render-qa-deliver misstjede Audio- oder Bild-Neutiming
G9 Untertitelkeine Untertitel-Elemente, sofern der Brief nicht danach fragtgrep von IDs/Klassen + <direction>-Zeileentfernen / in einer Zeile fragendieser SkillBriefänderung
G10 Render + QAEIN vollständiger Render in dieser Runde; frame_qa 0 Flags; Rubrik-Durchschnitt >= 4,0, keine Dimension < 3, M1/M3/M7 >= 3; jede Ledger-Zeile abgehaktQA-Berichte + Prüferausgabezurück zum fehlgeschlagenen Gate; max eine Korrekturrunde vor Eskalationrender-qa-deliverjeder vollständige Render

Gate-Ergebnisse protokollieren (hf/QA.md, eine Zeile pro Gate)

G1 pass   motion_spec_check exit 0, 24 Beats, Genehmigung "<wer> 2026-10-02"  (Neuausführung nach r2-Neutiming: pass)
G5 blocked  3D-Render coin_r2.png nicht lesbar für palette_audit (not_run) - Pillow installieren oder verkleinern
G7 fail   seek_safe_scan SS02 index.html:211 Math.random -> gesäter Hash; Rescan ausstehend

Ein Gate ohne Zeile ist not_run. Niemals aus dem Gedächtnis einer früheren Runde pass schreiben: Ein Neutiming, ein neues Asset oder ein Patch macht es ungültig (siehe Spalte Erneute Prüfung).

Einen Entwurf präsentieren (render-qa-deliver ist für das Liefer-Gate verantwortlich)

Nachricht = die Datei sofort + nummerierte Änderungen (nach den eigenen Notiznummern des Benutzers) + das Ledger mit jeder abgehakten Zeile + die Rubrik-Bewertung des separaten Prüfers + die Lücken (was NICHT verifiziert wurde: Hebräisch-Korrekturlesen, Geräte-Overlay, Lautstärke auf einem Telefon) + der Studio-Link. Niemals mit einem markierten Frame, einem fehlgeschlagenen Gate oder einer nicht abgehakten Ledger-Zeile präsentieren.

Referenzen (laden, wenn)

  • references/seam-camera-event-tables.md - IMMER beim Schreiben oder Überprüfen von PROMPT.md; auch agent-content/techniques/frame-spec-prompt.md und clean-smooth-motion.md.
  • references/launch-register-and-pace.md - Registerwahl, Tempo-Beschwerden, Verbotsliste, Easing-Zahlen.
  • references/three-d-decision.md - jeder Beat mit Tiefe oder 3D; agent-content/techniques/2-5d.md für 2.5D.
  • references/ui-sources-and-port.md - UI-Karten, Effekte, Screenshot-Animation; agent-content/techniques/screenshot-rebuild.md.
  • references/seek-safe-and-render-traps.md - Code schreiben, Patches, Render-Unterschiede.
  • references/palette-lock.md, references/typography-hebrew-kinetic.md, references/sound-and-captions.md - DESIGN.md, Hebräisch-Schrift, der Tonplan.
  • references/dated-versions.md - Pins und Lizenzen (datiert; abgelaufen = unbekannt).
  • Skripte (python <script> --self-check zuerst): motion_spec_check.py, palette_audit.py, seek_safe_scan.py. Sie prüfen Text und Muster, niemals das Erscheinungsbild.

Anhalten und eskalieren

Blocked, nicht geraten: keine Genehmigungszeile; kein Render möglich; eine Gate-Eingabe fehlt; ein Preis oder eine Lizenz unbekannt; ein Three.js-Beat, dessen 1 s Segment auf AMD leer ist (auf ein Blender-Sprite zurückfallen). Vor jeglichen Ausgaben, Installationen, Veröffentlichungen oder Nachrichten an Dritte fragen. Niemals andere Agent-Sitzungen kontaktieren. Eine Benutzernotiz „langweilig / sieht aus wie KI / statisch“ an einem Zeitstempel bedeutet, das Beat-Konzept aus dem Menü des Registers zu ersetzen, in einem Satz Erklärung.

Wartung

Flüchtige Fakten leben nur in references/dated-versions.md und den globalen datierten Modulen (hyperframes-traps.md, three-d-routes.md, audio-mix.md). Jede neue Notiz des Verantwortlichen zur Verbotszeile hinzufügen, nicht zu dieser Datei. Nur spezifizierte, deterministische Prüfungen; Modell-Evaluierung wird nicht ausgeführt (Entscheidungsstandard Q4).

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

>- 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).

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