Communitygithub.com

motion-language

Zeigt einem Agenten, wie er „Motion Language“ plant, baut oder zuschneidet, sodass das konkrete Ergebnis ein brauchbarer Text oder ein Skript ist. Das Verfahren durchläuft Motion Language, Die eine Unterscheidung, die zählt, Das Vokabular. Verwenden Sie es, wenn ein neuer Auftrag dieses Handwerk erfordert.

Was ist motion-language?

Diese Anleitung befähigt KI-Agenten, Motion-Design-Bibliotheken für Talking-Head-Erklärvideos zu planen, zu bauen und zu pflegen. Sie definiert eine Kernunterscheidung zwischen Szenen (die einen Argument liefern, 8–15s) und Stingers (die auf eine Idee gestisch hinweisen, 2–4s) – eine Verwechslung dieser beiden ist der häufigste Fehler. Die Anleitung enthält ein Vokabular aus fünf visuellen Elementen (Grund, Glas, Glanz, Pfad, Zustand) und eine Bibliothek von acht Stinger-Arten (z. B. `converge`, `steps`, `swap`, `countup`), die jeweils einen bestimmten narrativen Zweck erfüllen. Sie deckt auch die B-Roll-Behandlung (B-Rolle) ab, unterscheidet zwischen randlosem Filmmaterial und zitierfähigen Standbildern, und verweist für komplexere Animationen auf das größere Hyperframes-System, wobei strenge Regeln für Determinismus, Performanz und Barrierefreiheit eingehalten werden.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lucasaerb/workless-video-editor/tree/HEAD/skills/motion-language

In Ihrer bevorzugten KI fragen

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

Dokumentation

Motion Language

Erbt von skills/00-house-rules/SKILL.md. Die Implementierung ist scripts/stingers.py; die Galerie, die alles rendert, ist scripts/build_stinger_gallery.py.


Die eine Unterscheidung, die zählt

Eine Szene erklärt. Ein Stinger gestikuliert.

SzeneStinger
Länge8–15s2–4s
trägtein Argument, das man lesen musseine Idee, die man schon gehört hat
Gesichtverdeckt oder PiPverdeckt — man schneidet DARAUF
Anzahl3–6 in einem 10-minütigen Videoeiner alle 20–40s
wenn man es entferntdie Aussage kommt nicht andas Video wird flacher, nicht falsch

Dies falsch zu machen, ist der häufigste Fehler. Eine dreiteilige Liste mit echtem Inhalt ist eine compare-Szene; dieselbe Liste als steps ist Dekoration. Wenn ein Zuschauer sie lesen muss, ist es kein Stinger.

Stinger werden DARAUF geschnitten, nicht darüber gelegt. Sie besitzen den Frame für ihre wenigen Sekunden. Ein Vollbild-Grafik, bei dem der Sprecher noch dahinter sichtbar ist, wirkt wie ein Fehler, und 3 Sekunden ohne sein Gesicht kosten nichts.


Das Vokabular

Fünf Elemente. Alles in der Bibliothek ist eine Kombination daraus, was nicht zusammenhängende Animationen wie ein System lesbar macht.

GrundFast schwarz mit einem weichen radialen Anheben. Niemals flaches #000 — ein echter schwarzer Frame wirkt wie ein Ausfall, nicht wie ein Design.
GlasTransparente Füllung ~4.5% Deckkraft, 1px Rahmen ~14%, Radius 26. Tiefe kommt vom Rahmen und einer inneren Hervorhebung, niemals ein Schlagschatten auf der Karte.
GlanzEin flacher, spiegelnder Sweep über eine Karte, wenn sie sich setzt. Dies ist der charakteristische Move – es macht aus einem flachen Rechteck ein physisches Objekt.
PfadDünne, gestrichelte Kurven mit ~10% Deckkraft. Dinge bewegen sich entlang von Pfaden. Nichts teleportiert.
ZustandEine Reihe kleiner Punkte, die den Systemzustand anzeigen. Ein Farbwechsel in dieser Reihe sagt „und dann ist es kaputtgegangen“, ohne ein Wort Text.

Staffelung beträgt 120–160ms. Unter 100ms lesen sich Geschwister als ein Objekt; über 200ms beginnt der Zuschauer zu warten.

Jeder Stinger hält seinen letzten Frame. Er wird gegen Sprache geschnitten, daher muss es sicher sein, auf jedem Frame nach dem Höhepunkt zu enden. Nichts loopt; nichts endet auf einer leeren Bühne.


Die Bibliothek

{ "kind": "converge", "from": "everything feeds into one place", "dur": 3.4,
  "chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
kindDer Satz, unter den es gehörtdur
converge„All das fließt an einem Ort zusammen.“ Chips reisen auf gestrichelten Pfaden in einen leuchtenden Kern; die Zustandspunkte füllen sich, wenn er Last aufnimmt.3.0–3.6
overload„Und dann hat es aufgehört zu funktionieren.“ Derselbe Kern wird rot. Teilt die Geometrie von converge, sodass die beiden als eine Geschichte zusammengeschnitten werden können.2.4–3.0
steps„Es gibt drei davon.“ Nummerierte Glaskarten, gestaffelt, jede mit Glanz. Am wiederverwendbarsten und am meisten übernutzt.2.6–3.2
swap„Dies, nicht das.“ A wird durchgestrichen und fährt nach oben zurück; B erscheint darunter. Beide bleiben lesbar.3.0–3.6
countup„Es waren dreiundvierzig Prozent.“ Eine Zahl steigt, die Schriftgröße wächst mit dem Wert, über einer sichtbaren Quellenzeile.2.6–3.4
beatsDrei kurze Phrasen, perkussiv. Jede erhält einen anderen Eintritt auf einem gemeinsamen Beat-Raster.2.4–3.2
surround„Du bist in Werkzeugen begraben.“ Beschriftete Chips umringen ein gehaltenes Zentrum und rücken dann ein. Das Zentrum bewegt sich nie.3.2–4.0
photoEin gefundenes Bild, bearbeitet. Glaskarte, langsamer Ken Burns, Bildunterschrift, Quellenangabe.2.8–4.0
clipDieselbe Karte mit Filmmaterial anstelle eines Standbilds. Kein Ken Burns — es bewegt sich bereits.2.4–3.0

Verwenden Sie sie in composition.json genau wie eine Szene – gleiche from- / at- / dur-Verankerung, gleicher harter Fehler, wenn die Phrase nicht aufgelöst wird.


B-Rolle: der photo / clip Stinger

Zwei Behandlungen, und full wählt zwischen ihnen aus. full ist Opt-in; lassen Sie es weg und Sie erhalten die Karte.

full: true — B-ROLLfull: false — ZITAT
Framerandlos, keine KarteGlaskarte, Glanz, langsame Drift
Text auf dem Frameein unteres Drittel, das benennt, was die Aufnahme istBildunterschrift und Quellenangabe
Quelle auf dem Framenieerforderlich
Verwendung fürFilmmaterial und Standbilder, die einen Moment tragenein Screenshot, ein Diagramm, eine Preisseite, ein Dokument

B-Rolle ist Vollbild und trägt keine Quellenangabe. Stehende Anweisung vom Menschen, 2026-08-14. Sie nimmt den gesamten Frame ein, so wie B-Rolle in jedem Schnitt, den jemand gesehen hat. Der einzige Text, der darüber erlaubt ist, ist ein unteres Drittel, das sagt, was die Aufnahme ist, niemals woher sie kommt. Die Quellenangabe erfolgt trotzdem – in der _FINAL/ATTRIBUTION.md des Drops, die fetch_stock.py beim Herunterladen schreibt und die kein Schnitt überspringen kann. Pexels und Pixabay machen die Quellenangabe auf dem Frame optional, also erfüllt das Protokoll die Lizenz von selbst und der Frame bleibt sauber.

Dies ersetzt den Absatz, der früher hier für B-Rolle stand, der besagte, dass ein randloser Clip „wie ein anderes Video“ wirkt und alles in eine Karte packt. Diese Begründung gilt immer noch für den Zitierungsfall und nur dafür: wenn der Zuschauer das Asset als Beweis lesen soll, den man zitiert, kehren full: false und die Quellenzeile auf den Frame zurück.

Der Builder standardmäßig immer noch auf die Karte, und das ist beabsichtigt. Das Umkehren des Standards würde stillschweigend jede bereits dagegen geschriebene photo-Szene neu behandeln – darunter drop-005s working/stingers/plan.json – und eine Spezifikation, die gestern eine Karte gerendert hat, muss heute dieselbe Karte rendern. Neue Arbeit fragt nach "full": true; skills/executive-animator tut das immer. Die Ein-Wort-Änderung in st_photo ist alles, was nötig ist, falls die Karte jemals ganz ausgemustert wird.

Eine Geometrie-Anmerkung: randlos verwendet object-fit: cover, also geben Sie eine Quelle an, die bereits 16:9 ist. Ein 2,19:1-Beschnitt, der im Vollbild gezeigt wird, verliert auf jeder Seite 221px, was dazu führt, dass ein Diagramm mit seiner ersten und letzten abgeschnittenen Spalte endet, während jedes Tor eine korrekte Box meldet.

Ein Builder, zwei Namen. photo für ein Standbild, clip für Filmmaterial; es verzweigt anhand der Dateierweiterung, also existiert der Name nur, um eine Spezifikation lesbar zu machen. Was sich tatsächlich ändert:

photoclip
Element<img><video muted playsinline> mit Framework-Timing
Ken Burnsja, 1,00 → 1,07 über die Kartekeiner

Filmmaterial erhält keinen Ken Burns. Der Clip liefert seine eigene Bewegung, und eine Größenänderung über einer echten Bewegung ist genau das, was Stockmaterial wie Stockmaterial aussehen lässt. Ein Standbild ist bewegungslos und braucht die Drift, um lebendig zu bleiben; ein Clip nicht.

// B-Rolle. Vollbild, unteres Drittel sagt, was es ist, keine Quelle auf dem Frame.
{ "kind": "clip", "from": "everything is moving at once", "dur": 3.0,
  "src": "broll/cut-data-flow.mp4", "caption": "Everything moving at once" }

// Zitat. Ein Dokument, das der Zuschauer als Beweis liest, also kommen die Karte und die Quellenangabe zurück.
{ "kind": "photo", "full": false, "from": "the pricing page changed", "dur": 3.2,
  "src": "assets/pricing.png", "caption": "Anthropic pricing, Aug 2026",
  "credit": "ANTHROPIC.COM · FETCHED 2026-08-13" }

Das untere Drittel sitzt bei cap_left / cap_bottom, standardmäßig 96 / 186 — Querformat, was die 96 links und 132 unten von youtube_long freihält. Ein 9:16-Aufrufer muss sein eigenes cap_bottom übergeben: Reels reservieren 520 unten und die Karaoke-Band belegt y 1150–1400, also landet die Querformat-Voreinstellung eine Bildunterschrift unter dem Fortschrittsbalken. Es gibt kein Paar, das in beiden Frames richtig ist.

src löst relativ zur Spezifikationsdatei auf und der Builder kopiert sie in das Verzeichnis assets/ des Projekts, also schlägt ein falscher Pfad laut beim Build fehl, anstatt als leere Karte. Holen Sie beide aus scripts/fetch_stock.py, das den Block druckt, der bereit zum Einfügen ist.

Die Quellenangabe ist eine Protokollverpflichtung, keine Frame-Verpflichtung. Jedes Tier-3-Asset erhält seine Zeile in der _FINAL/ATTRIBUTION.md des Drops, geschrieben von fetch_stock.py zum Zeitpunkt des Herunterladens – das ist was config/broll-policy.md vorschreibt und es ist nicht optional. Ob die Quellenangabe auch auf dem Frame erscheint, ist eine Designentscheidung, und für B-Rolle lautet die Antwort nein. Auf einer Zitierkarte bleibt sie, wird mit WCAG AA gerendert, und eine Quellenangabe, die niemand lesen kann, ist keine Quellenangabe.

Lösen Sie jedes Bild zuerst in der Tier-Reihenfolge auf. Ein Foto ist Tier 3: greifen Sie nur darauf zurück, wenn Ihr eigenes Filmmaterial und eine Tier-2-Überlagerung beide wirklich nichts haben. Der Ken Burns läuft auf dem <img> innerhalb der zuschneidenden Karte, niemals auf der Karte selbst.

⚠ Kopieren Sie nicht das lange Drittanbieter-Video-Einfügemuster. Die Referenz, aus der diese Sprache stammt, verwendet 50 Sekunden Interviewmaterial von jemand anderem. config/broll-policy.md verbietet das kategorisch, und keine noch so gute Bewegungsgrafik macht es zu unserem. Fotos mit Quellenangabe sind in Ordnung; ein ganzes Video zu übernehmen, ist es nicht.


Das breitere Menü – wonach greifen, wenn nichts oben passt

Zwei übergeordnete Korpora existieren und beide sind größer als diese Bibliothek. Lesen Sie daraus, anstatt Bewegungen zu erfinden.

hyperframes-animation Skill — 48 atomare Regeln + 22 Szenen-Blaupausen. Laden Sie es mit Skill(hyperframes-animation), öffnen Sie dann rules-index.md und lesen Sie die eine Regel, die Sie benötigen, unter rules/<name>.md. Die Hausvoreinstellung ist 2–4 atomare Regeln auf einer pausierten Timeline komponieren; eine Blaupause ist für den Fall, dass Sie einen ganzen 4–5-Phasen-Schuss möchten.

Die Block-Registrierung — 373 installierbare Blöcke: npx hyperframes catalog --query "<conzept>", dann npx hyperframes add <block>.

Situation → Regel

Kuratiert für einen Talking-Head-Erklärer. Dies sind die Regeln, die unser Format überleben; die restlichen 48 nehmen meist eine Produkt-UI oder einen gesteuerten Cursor an, den wir nicht haben.

wenn die Zeile ist…Regelwarum sie passt
eine Zahl, eine Statistik, ein Prozentsatzcounting-dynamic-scale, stat-bars-and-fillsbereits als countup implementiert; verwenden Sie die Regeln direkt für Balken, Ringe, Sternfüllungen
eine knackige Liste, im Schnellfeuerkinetic-beat-slam, waterfall-entryals beats implementiert; waterfall-entry ist die sanftere Kaskade
eine Definition oder ein Begriff landetgradient-text-sweep, depth-scatter-assembledie Glyphen bewegen sich nie in der ersten; die zweite setzt sie aus der Tiefe zusammen
„hier ist die Form davon“ (ein Diagramm)svg-path-drawdie Umrisslinie zeichnet sich selbst. Messen Sie mit getTotalLength() bei der Einrichtung
„es ist umgeben / begraben / verbunden“radial-surround, avatar-cloud-network, orbit-3d-entryals surround implementiert; die anderen beiden fügen Verbindungslinien und 3D-Eintritt hinzu
eine Idee ersetzt eine anderescale-swap-transition, card-morph-anchor, morph-swapals swap implementiert; card-morph-anchor verwandelt den Container selbst
„schau genauer hierhin“depth-of-field-blur, coordinate-target-zoom, viewport-changeRack-Fokus oder eine virtuelle Kamera auf einem .world-Wrapper
Betonung auf einem gesprochenen Wortasr-keyword-glow, css-marker-patternsLeuchten synchron zu Wortzeitstempeln – wir haben bereits gemessene Wortzeiten
ein harter, perkussiver Akzentchromatic-glitch, particle-burst, motion-blur-streaksparsam verwenden; höchstens einmal pro Video
ein ruhiger Landebeattitlecard-reveal (Blaupause), ambient-glow-bloomwenig Bewegung ist die eigentliche Botschaft, kein Mangel
jeder Eintritt überhauptspring-pop-entranceder kanonische Pop. Im Zweifelsfall dieser

Blaupausen, die es wert sind, bekannt zu sein

Die meisten der 22 sind Produktlaunch-Anzeigenformen. Vier passen zu dem, was wir tatsächlich machen:

  • kinetic-type-beats — das Arbeitstier. Die Wörter tragen den Schuss, kein Set, keine Oberfläche.
  • dataviz-countup — wenn die Daten das Argument tragen.
  • comparison-split — zwei Fähigkeiten gleichzeitig abgewogen (unsere compare-Szene ist ein flacher Cousin).
  • titlecard-reveal — der Atemhol-Beat, genau eine zurückhaltende Bewegung.

Überspringen Sie cursor-ui-demo, device-surface-showcase, cta-morph-press, prompt-type-submit-generate und den Rest der Demo-Familie, es sei denn, wir zeigen tatsächlich eine Produkt-UI. Sie sind exzellent und sie sind nicht unser Format – ein Talking-Head-Erklärer, der plötzlich eine gefälschte App-Demo aufführt, wirkt wie eine Werbung.

Der Vertrag, den jede übergeordnete Regel annimmt

Wissenswert, bevor man eine kopiert, denn diese zu brechen, lässt den Check nicht fehlschlagen – es lässt den Render fehlschlagen:

  • EINE pausierte GSAP-Timeline auf window.__timelines. Niemals Autoplay, niemals eine zweite Timeline.
  • Seek-sicher in beide Richtungen – fromTo mit expliziten From-Zuständen, absolute Werte, niemals relative +=. Der Zustand muss eine reine Funktion der Timeline-Zeit sein.
  • Deterministisch – kein Math.random(), kein Date.now(). Nur index-basiertes Pseudo-Random. Endliche Wiederholungen, niemals repeat: -1.
  • Nur Transforms und Paint. Tween auf width / height / top / left sind verboten; verwenden Sie Skalierungs-/Verschiebungs-Proxys oder Masken.
  • Gruppen-Staffelungen sind so begrenzt, dass eine Ankunft als ein Beat gelesen wird – items × stagger ≤ ~0,5s.
  • Berechnen Sie Layout-Konstanten vor. Leiten Sie niemals eine Position zur Tween-Zeit ab; der Renderer tastet parallel ab und die Messung desynchronisiert.

Hinzufügen eines neuen Konzepts

  1. Durchsuchen Sie zuerst die Registrierung – npx hyperframes catalog --query "<conzept>". 373 Blöcke existieren. radial-surround, morph-swap, split-tilt-cards und particle-image-reveal sind enge Verwandte von Dingen in dieser Bibliothek und können ein besserer Ausgangspunkt sein als neuer Code.
  2. Bauen Sie es aus den fünf obigen Elementen. Ein Konzept, das ein sechstes Element benötigt, ist entweder eine Szene, oder ein Zeichen dafür, dass das Vokabular eine bewusste Erweiterung braucht – keine Ausnahme.
  3. Fügen Sie es zu KINDS in scripts/stingers.py hinzu.
  4. Rendern Sie die Galerie und betrachten Sie sie alle zusammen. Nur so kann man feststellen, ob ein Neues zur Familie gestoßen ist oder nur daneben gelandet ist.
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png

Drei Mängel, die diese Bibliothek bereits entdeckt hat

Jeder bestand einen sauberen hyperframes check, bevor jemand auf einen Frame sah:

  1. GSAP kann ::after nicht animieren. Es löst Ziele mit querySelector auf, was niemals ein Pseudo-Element zurückgibt, also tat jeder Glanz stillschweigend nichts. Der Glanz ist jetzt ein echtes untergeordnetes Element (SHEEN_EL). Wenn Sie eine Karte hinzufügen, setzen Sie sie hinein.
  2. GSAP kann nicht

Individual skills in this repo

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

Verwandte Skills