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.
| Szene | Stinger | |
|---|---|---|
| Länge | 8–15s | 2–4s |
| trägt | ein Argument, das man lesen muss | eine Idee, die man schon gehört hat |
| Gesicht | verdeckt oder PiP | verdeckt — man schneidet DARAUF |
| Anzahl | 3–6 in einem 10-minütigen Video | einer alle 20–40s |
| wenn man es entfernt | die Aussage kommt nicht an | das 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.
| Grund | Fast schwarz mit einem weichen radialen Anheben. Niemals flaches #000 — ein echter schwarzer Frame wirkt wie ein Ausfall, nicht wie ein Design. |
| Glas | Transparente Füllung ~4.5% Deckkraft, 1px Rahmen ~14%, Radius 26. Tiefe kommt vom Rahmen und einer inneren Hervorhebung, niemals ein Schlagschatten auf der Karte. |
| Glanz | Ein flacher, spiegelnder Sweep über eine Karte, wenn sie sich setzt. Dies ist der charakteristische Move – es macht aus einem flachen Rechteck ein physisches Objekt. |
| Pfad | Dünne, gestrichelte Kurven mit ~10% Deckkraft. Dinge bewegen sich entlang von Pfaden. Nichts teleportiert. |
| Zustand | Eine 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"] }
| kind | Der Satz, unter den es gehört | dur |
|---|---|---|
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 |
beats | Drei 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 |
photo | Ein gefundenes Bild, bearbeitet. Glaskarte, langsamer Ken Burns, Bildunterschrift, Quellenangabe. | 2.8–4.0 |
clip | Dieselbe 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-ROLL | full: false — ZITAT | |
|---|---|---|
| Frame | randlos, keine Karte | Glaskarte, Glanz, langsame Drift |
| Text auf dem Frame | ein unteres Drittel, das benennt, was die Aufnahme ist | Bildunterschrift und Quellenangabe |
| Quelle auf dem Frame | nie | erforderlich |
| Verwendung für | Filmmaterial und Standbilder, die einen Moment tragen | ein 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:
photo | clip | |
|---|---|---|
| Element | <img> | <video muted playsinline> mit Framework-Timing |
| Ken Burns | ja, 1,00 → 1,07 über die Karte | keiner |
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… | Regel | warum sie passt |
|---|---|---|
| eine Zahl, eine Statistik, ein Prozentsatz | counting-dynamic-scale, stat-bars-and-fills | bereits als countup implementiert; verwenden Sie die Regeln direkt für Balken, Ringe, Sternfüllungen |
| eine knackige Liste, im Schnellfeuer | kinetic-beat-slam, waterfall-entry | als beats implementiert; waterfall-entry ist die sanftere Kaskade |
| eine Definition oder ein Begriff landet | gradient-text-sweep, depth-scatter-assemble | die Glyphen bewegen sich nie in der ersten; die zweite setzt sie aus der Tiefe zusammen |
| „hier ist die Form davon“ (ein Diagramm) | svg-path-draw | die Umrisslinie zeichnet sich selbst. Messen Sie mit getTotalLength() bei der Einrichtung |
| „es ist umgeben / begraben / verbunden“ | radial-surround, avatar-cloud-network, orbit-3d-entry | als surround implementiert; die anderen beiden fügen Verbindungslinien und 3D-Eintritt hinzu |
| eine Idee ersetzt eine andere | scale-swap-transition, card-morph-anchor, morph-swap | als swap implementiert; card-morph-anchor verwandelt den Container selbst |
| „schau genauer hierhin“ | depth-of-field-blur, coordinate-target-zoom, viewport-change | Rack-Fokus oder eine virtuelle Kamera auf einem .world-Wrapper |
| Betonung auf einem gesprochenen Wort | asr-keyword-glow, css-marker-patterns | Leuchten synchron zu Wortzeitstempeln – wir haben bereits gemessene Wortzeiten |
| ein harter, perkussiver Akzent | chromatic-glitch, particle-burst, motion-blur-streak | sparsam verwenden; höchstens einmal pro Video |
| ein ruhiger Landebeat | titlecard-reveal (Blaupause), ambient-glow-bloom | wenig Bewegung ist die eigentliche Botschaft, kein Mangel |
| jeder Eintritt überhaupt | spring-pop-entrance | der 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 (unserecompare-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 –
fromTomit expliziten From-Zuständen, absolute Werte, niemals relative+=. Der Zustand muss eine reine Funktion der Timeline-Zeit sein. - Deterministisch – kein
Math.random(), keinDate.now(). Nur index-basiertes Pseudo-Random. Endliche Wiederholungen, niemalsrepeat: -1. - Nur Transforms und Paint. Tween auf
width/height/top/leftsind 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
- Durchsuchen Sie zuerst die Registrierung –
npx hyperframes catalog --query "<conzept>". 373 Blöcke existieren.radial-surround,morph-swap,split-tilt-cardsundparticle-image-revealsind enge Verwandte von Dingen in dieser Bibliothek und können ein besserer Ausgangspunkt sein als neuer Code. - 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.
- Fügen Sie es zu
KINDSinscripts/stingers.pyhinzu. - 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:
- GSAP kann
::afternicht animieren. Es löst Ziele mitquerySelectorauf, 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. - GSAP kann nicht