Communitygithub.com

yazzang-homelab/motion-studio

Erstellt eine sechsteilige XML-Zustandsspezifikation für einen Ein-Form-UI-Morph-Film (Eingaben, Richtung, Struktur, Aufbau, Fallstricke, Start): Zustände auf Downbeats, cursorgesteuerte Änderungen, nahtlose Schleife, Freigabeschleuse. Verwendung für 'UI-Morph', 'Zustandsliste'.

Was ist motion-studio?

Dieses Skill definiert eine präzise, strukturierte Methode zur Erstellung von UI-Morph-Animationen, bei denen eine einzelne Form kontinuierlich durch verschiedene Zustände (z. B. Button, Ladebalken, Diagramm) wechselt, ohne jemals einen Schnitt zu machen. Es basiert auf einer sechsteiligen XML-Spezifikation (Eingaben, Richtung, Struktur, Aufbau, Fallstricke, Start), die es dem KI-Agenten ermöglicht, systematisch Kundenanforderungen zu sammeln und einen detaillierten, dokumentierten Filmplan zu erstellen. Der Kern des Skills sind die planmäßige Platzierung der Zustände auf Downbeats eines Beat-Gitters, die Implementierung einer Schleife, bei der der letzte Zustand nahtlos in den ersten übergeht, und eine Freigabeschleuse (Gate), die die Zustimmung des Benutzers einholt, bevor Code geschrieben wird. Es unterstützt die Plattformen motion-studio und CLI-Tools wie init.mjs, score.mjs und statelist.mjs, um Projekte zu initialisieren, Zeitpläne zu berechnen und Zustandslisten zu generieren. Die KI erstellt eine film.js-Datei mit präzisen Animationen, cursor-gesteuerten Änderungen und Schleifen-Logik. Eine gründliche Kritikschleife stellt sicher, dass alle Metriken (z. B. Schleifennähte, Kontaktpositionen) erfüllt werden, bevor der Film gebaut wird.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/ui-morph-spec

In Ihrer bevorzugten KI fragen

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

Dokumentation

UI-Morph-Spezifikation (Kursschritt 06, Level L3)

Schreibe die Zustandsliste, nicht die Stimmung. Das am meisten mit Lesezeichen versehene Prompt der Opus 5.5-Startwoche war kein Einzeiler: @twoclipping's UI-Morph-Schleife und @verbove's MakerMap-Film verwendeten beide eine XML-Spezifikation mit Eingaben, Richtung, einer beat-genauen Zustandsliste, Aufbauregeln und Fallstricken. Die Idee dahinter: eine Form, die niemals geschnitten wird. Ein einzelnes Element ändert Größe, Radius und Farbe von Zustand zu Zustand (Button, Ladebalken, Player, Diagramm, Befehlspalette), ein Cursor verursacht jede Änderung mit einem echten Klick, und der letzte Frame entspricht dem ersten, sodass die Schleife läuft.

Anforderungsargumente (können leer sein), einmal angezeigt:

Quellenangabe: Das sechsteilige Layout folgt @twoclipping's öffentlicher Vorlage (https://x.com/twoclipping/status/2103273003555402193; das XML befindet sich im Hauptbeitrag, nicht in einem Thread-Antwort wie der Kurs sagt) und @verbove's MakerMap-Spezifikation (https://x.com/verbove/status/2103483957266268381). Die Vorlage in diesem Skill ist in motion-studios eigenen Worten geschrieben: assets/spec-template.xml.

1. Fordere die Eingaben an

Frage in einer einzigen AskUserQuestion-Runde (Unter-Agenten können nicht fragen; du tust es):

EingabeStandardRegel
Produkt + URLerforderlichErfasse die echte UI und kopiere sie mit /motion-studio:product-reel Stufe 3, wenn eine URL vorhanden ist
8 bis 12 Zustände in Reihenfolge der GeschichteLogo, CTA, E-Mail-Feld, Ladebalken, Haken, Karte, Diagramm, Befehlspaletteeiner pro Downbeat
Echte Daten pro ZustandFragenBeschriftungen, Zahlen, Namen aus dem Produkt; keine Platzhalter
Markenfarben, Schriftarten, eine Akzentfarbeaus Capture oder studio.jsoneine Akzentfarbe
TrackSynthetisiere minimal bei 120 BPMEin bereitgestellter Track muss diese Nutzung erlauben und auf einem Downbeat beginnen
Formate9x16, 1x1, 16x9Gleicher Zeitplan, neu gerahmt
SchleifejaDer letzte Zustand morphiert zurück in den ersten

2. Fülle die Spezifikation aus

Kopiere die Vorlage in das Projekt als docs/spec.xml und fülle jedes [...] mit den Antworten aus. Behalte alle sechs Abschnitte bei: <inputs>, <direction>, <structure>, <build>, <gotchas>, <start>. Der motion-director-Unter-Agent (motion-studio:motion-director) kann sie aus deiner Besprechung entwerfen; er schreibt nur unter docs/.

3. Platziere die Zustände auf dem Beat-Gitter

  1. Projekt: Struktur mit --loop falls nötig (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <verz> --title "<Produkt> morph" --loop --duration <S> --install; in einer Nur-Skills-Installation verwende node "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ... mit denselben Flags oder rufe das studio-init-Skill auf).

  2. Gitter: node tools/score.mjs --style minimal --bpm 120 --duration <S>, oder messe den bereitgestellten Track mit node tools/beats.mjs audio/<track>.

  3. Zustandsliste mit genauen Downbeat-Zeiten, Schleifenprüfungen und Warnungen:

    node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "Logo,CTA-Button,E-Mail-Feld,Ladebalken,Haken,Karte,Diagramm,Palette" --out docs/statelist.md
    
    FlagVerwendung
    --states "a,b:2,c" oder --file liste.txtZustände in Reihenfolge; :2 hält einen Zustand für zwei Takte
    --beats audio/beats.jsonGemessenes Gitter (Standard, wenn die Datei existiert); --beats none ignoriert es
    --bpm N, --beats-per-bar NÜberschreibe das Gitter
    --no-loopEin Film, der endet statt zu loopen
    --jsonEine JSON-Zeile mit Start, Ende und Content-Timing jedes Zustands

    Es warnt, wenn die Schleifenlänge von der duration in studio.json abweicht, wenn der erste Zustand nicht bei 0 s liegt (ein Auftakt im Track), oder wenn ein Zustand unter 1 s gehalten wird. Korrigiere die Dauer oder passe den Track an, bevor du fortfährst.

  4. Fülle die Spalten Cursor-Aktion, Daten und Sound von docs/statelist.md aus und kopiere die Tabelle in docs/shotlist.md.

4. Die Schleuse

Zeige die Zustandsliste auf dem Beat-Gitter an und warte auf das OK des Benutzers, bevor du Filmcode schreibst (der <start>-Abschnitt sagt das, und der Kurs tut es auch). Eine abgelehnte Liste wird umgeschrieben, nicht umprogrammiert. Halte die Entscheidung in der Zeile Status: von docs/shotlist.md fest.

5. Baue aus dem verifizierten Beispiel

Kopiere assets/morph-loop.film.js nach film/film.js und passe es an: Es ist eine funktionierende 16-Sekunden-, 8-Zustands-Schleife bei 120 BPM, die in jedem Format rendert. Ersetze STATES (Größen in 1080 px Einheiten, Füllungs-Token), COPY und die content-Maler mit der genehmigten Liste und den echten Daten; behalte die Mechaniken bei:

MechanikAPIRegel
Zustandszeitengrid.bar(i)Niemals eingegebene Sekunden
Containergröße, Radius, Farbkanäle, Kamera-ZoomloopTrack(t, keys, dauer, spring)Schlüssel in [0, dauer]; die Naht ändert sich einmal, als Schlüssel beim ersten Downbeat (dieses Beispiel) oder bei t = dauer
Content ein- und ausblendenswapAlpha(t, start, nächsterStart)ein, nachdem der Morph beginnt, aus vor dem nächsten
CursorloopTrack auf x und y, cursor(g, x, y, { gedrückt })Klickt das aktuelle Element auf dem Downbeat
Tabs und Listen-Highlightsindicator(t, stops, { breite })Ränder auf unterschiedlichen Federn
Soundscues von grid.bar und grid.beatKlick bei Drücken, Wischgeräusch unter Morphs
Körnung und andere frame-indizierte Störungengrain(g, B, H, c.frame % LOOP_FRAMES, ...) mit LOOP_FRAMES = Math.round(dauer * fps)Die Kritik vergleicht hash(0) mit hash(dauer, { wrap: false }); Störungen, die durch den rohen Frame-Index gesät werden, lassen das Ende sich von Frame 0 unterscheiden und bestehen die Schleifenprüfung nicht

Jedes Muster mit seiner Begründung: references/morph-recipes.md. Setze in studio.json "loop": true und "duration" auf die Schleifenlänge, dann npm run lint.

6. Kritik und Auslieferung

Führe die Kritikschleife von /motion-studio:motion-reel aus (mindestens 3 Runden, alle Achsen >= 8, keine offenen P0; jede Runde baut den gemischten Render und beide Nachweise laufen zuerst, siehe sein Pipeline-Runbook). Überprüfe für Morph-Schleifen auch out/review/<fmt>/loop.png (nur Live-Durchlauf; der video/-Durchlauf hat kein Schleifen-Panel) und die Metrik "Schleifennaht" (hash(0) gleich hash(dauer, { wrap: false }), Kontinuitätsverhältnis <= 1.5; das |ende - anfang|-Panel muss schwarz sein, was frame-indizierte Körnung zerstört, es sei denn, ihr Index wickelt sich), Beschriftungen während jedes Wechsels in strip.png, und die Cursorposition bei jedem Downbeat in contact.png. Ein Nahtsprung ist ein P0. Dann npm run build.

Regeln für Morph-Filme

  • Ein Container, niemals geschnitten. Zustände unterscheiden sich nur durch Größe, Radius, Füllung und Inhalt.
  • Ein Cursor verursacht jede Änderung; kein Zustand ändert sich von selbst.
  • Irgendetwas bewegt sich bei jedem Beat: ein Drücken, Tippen, ein Zähler, eine Linienzeichnung, ein Highlight-Schritt.
  • Nur echte Produktdaten. Federn mit höchstens einer Andeutung von Überschwingen; keine bei Schriftarten.
  • Verboten: hüpfende Easing-Funktionen, Leuchteffekte, Verläufe auf UI-Chrome, Partikelausbrüche, tote Beats.
  • Niemals will-change (oder einen Rasterisierungstrick) auf etwas verwenden, das die Kamera skaliert.

Als nächstes: /motion-studio:springs um das Gefühl zu optimieren; /motion-studio:ship-formats für die formatbezogene Neurahmung und Auslieferung.

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

Verwandte Skills