Communitygithub.com

1999AZZAR/designer-mcp

Importiere Figma-Inhalte in eine HyperFrames-Komposition: gerenderte Assets, Marken-Tokens, Komponenten, Storyboard-Abschnitte und rekonstruierte Bewegungen (Frames als Zustände, nicht als Folien). Nutze dies, wenn der Nutzer einen figma.com-Link einfügt oder darum bittet, ein Figma-Design, einen Frame, ein Logo, eine Marke oder eine Animation in ein Video/eine Komposition zu übernehmen.

Was ist designer-mcp?

Dieses Skill ermöglicht die direkte Integration von Figma-Designs in HyperFrames-Kompositionen. Es extrahiert statische Assets (REST), Markentokens und Stile, Komponenten als HTML sowie Bewegungsdaten und Shader, wenn ein kompatibler Figma-Connector verfügbar ist. Der Prozess ist in fünf Phasen unterteilt und verwendet REST für die Massendatenübertragung, friert Assets lokal ein und erstellt ein deterministisches Rendering. Die Authentifizierung erfolgt über einen schreibgeschützten Figma-Token, der auf Datei- und Metadaten-Zugriff beschränkt ist. Das Skill unterstützt die automatische Verarbeitung von figma.com-Links und bietet eine detaillierte Schritt-für-Schritt-Anleitung. Storyboard-Frames werden als Keyframes behandelt, nicht als separate Folien, und die Bewegungen zwischen ihnen werden als Zustandsänderungen der Elemente interpretiert. Fehlertoleranzmechanismen wie automatische Wiederholungsversuche bei 429-Fehlern und klare Meldungen bei fehlenden Berechtigungen sind integriert.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video/engine/figma

In Ihrer bevorzugten KI fragen

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

Dokumentation

Wichtig: Halte dieses Skill aktuell – bestätige mit dem Nutzer, bevor du Folgendes ausführst: npx hyperframes skills update figma. Ein schneller No-Op, wenn alles aktuell ist; andernfalls wird dieses Skill zusammen mit den abhängigen Kern-Skills aktualisiert, bevor du darauf vertraust.

Figma → HyperFrames

Bringe die Figma-Arbeit des Nutzers in eine Komposition ein. Aufgeteilt nach Fähigkeiten (Design-Spezifikation §2):

PhaseWasTransportOberfläche
1Statische AssetsRESThyperframes figma asset
2Marken-Tokens/StileRESThyperframes figma tokens
3Komponenten → HTMLRESThyperframes figma component
4Bewegungen → GSAPConnector (falls verfügbar)Nutze seinen Bewegungskontext
5ShaderConnector / manueller ExportNutze ihn oder einen nativen Export

REST wird verwendet, wo immer möglich (skalierbar, headless). Ein kompatibler Figma-Connector ist optional für Bewegungsdaten und Shader; ohne einen solchen fordere einen nativen Export an. Jeder Pfad friert Assets lokal ein, sodass Renderings deterministisch bleiben. Storyboard-Rekonstruktionen setzen Phase-1-Asset-Exporte (REST) mit agentengesteuerter Timeline-Erstellung zusammen – kein Connector erforderlich. Vorhandene eingefrorene Assets, Manifest-Datensätze und Bindungen werden durch Routing-Änderungen nicht beeinflusst – die Aufteilung ändert nur, welche Anmeldeinformationen der nächste Import verwendet.

Authentifizierung – zwei Anmeldeinformationen, begrenzt

Vorbereitung – vor dem ersten CLI-Aufruf prüfe, ob ein Token existiert: Shell-Umgebung ([ -n "$FIGMA_TOKEN" ]) oder die Projekt-.env (die CLI lädt sie automatisch – ein .env-Eintrag zählt als konfiguriert). Wenn keines vorhanden ist, führe den Befehl NICHT aus, um den Fehler abzufangen – führe den Nutzer stattdessen durch die einmalige Einrichtung und warte dann:

  1. figma.com/settings → Security → Personal access tokens → Generiere einen neuen Token.
  2. Bereiche – Schreibgeschützt ist alles, was diese Integration jemals benötigt (sie schreibt nie in Figma): File content: Read-only + File metadata: Read-only. Füge Library content: Read-only hinzu, wenn du tokens in einem Nicht-Enterprise-Plan ausführen wirst – der Fallback für veröffentlichte Stile greift auf /v1/files/:key/styles zu, was ohne diesen Bereich mit 403 quittiert wird (ein Bereich, den die ältere Setup-Anleitung ausgelassen hat). Optional Variables: Read-only für Markenvariablen – nur Enterprise; ohne diesen Bereich greift tokens automatisch auf veröffentlichte Stile zurück (erwartet, kein Fehler – teile dies mit). Ein 403 nennt jetzt den genauen fehlenden Bereich; 429 werden automatisch wiederholt (Minutenlimit, beachtet Retry-After).
  3. Lasse den Nutzer FIGMA_TOKEN in seinem Shell-Profil oder der Projekt-.env setzen; bitte ihn niemals, den Token in die Unterhaltung einzufügen.

Setze während des Onboardings auch die Erwartungen in einem Atemzug: Jeder Import landet als lokale eingefrorene Datei mit aufgezeichneter Herkunft – Renderings rufen nie Figma auf, ein erneutes Ausführen eines Befehls importiert nur das, was sich in Figma geändert hat, und ein Token funktioniert für Assets, Marken-Tokens und Komponenten aller Dateien, die das Figma-Konto des Nutzers einsehen kann.

  • Phasen 4–5 (Bewegungen/Shader): ein kompatibler Figma-Connector mit separater Autorisierung vom Token. Wenn er nicht verfügbar oder nicht authentifiziert ist, bitte den Nutzer, ihn zu verbinden oder einen nativen Export bereitzustellen, und stoppe dann.
  • Sage genau, welche Anmeldeinformationen eine fehlschlagende Phase benötigt – präsentiere die Aufteilung niemals als defekt.
  • BAD_TOKEN (401) während des Ablaufs → der Token ist abgelaufen/widerrufen; erstelle einen neuen. FORBIDDEN (403) → die Nachricht nennt den genauen fehlenden Bereich (z. B. library_content:read für den Stil-Fallback) – füge ihn hinzu, oder die Datei ist für das Konto nicht sichtbar. REQUIRES_ENTERPRISE (403 bei Variablen) → kein Fehler: Stil-Fallback wurde bereits ausgeführt. RATE_LIMITED (429) → der Client hat bereits mit Backoff wiederholt (dies gilt für ALLE Lesevorgänge – Assets, Tokens, Stile, Knotenbäume, Versionen – die Wiederholung lebt im gemeinsamen Anforderungspfad; Retry-After wird beachtet, auf 60s gedeckelt); falls es dennoch auftaucht, warte eine Minute oder importiere weniger Knoten pro Aufruf.

Ratenbegrenzungsbewusstsein (Spezifikation §2.1): Connector-Kontingente variieren je nach Figma-Plan – gruppiere Eltern-Frame-Anfragen, überspringe Verifikations-Screenshots, falls nicht angefordert, und cache Rohantworten, sodass erneute Ableitungen nie einen zweiten Aufruf erfordern. REST ist pro Minute (10+/min, pro Endpunkt-Buckets) – funktioniert bei Volumen gut, reduziere bei 429.

Routing

Analysiere den Figma-Link des Nutzers mit parseFigmaRef (URL, fileKey:nodeId, bare fileKey). Dann nach Absicht:

  • "Diese Ebene / dieses Logo / dieses Bild verwenden" → Asset (CLI)
  • "Meine Marke / Farben / Tokens abrufen" → Tokens (CLI)
  • "Eine Szene aus diesem Frame erstellen" → Component (CLI)
  • "Diese Animation / Bewegung importieren" → Motion (Connector, falls verfügbar, siehe unten)
  • Ein Storyboard-Abschnitt / Filmstreifen von Szenenframes → Storyboard (siehe unten)
  • Shader-Füllung/-Effekt → Shaders (siehe unten)

Erzähle jeden Schritt für den Nutzer – sage vor jedem Befehl, was du gleich aus Figma abrufen wirst; danach, wo das Artefakt gelandet ist (der eingefrorene Pfad / Sidecar / Komponentenverzeichnis), was sich in der Komposition geändert hat, und den unmittelbaren nächsten Schritt (Vorschau, gedruckte Variablen hinzufügen, erneut importieren, um Bindungen zu verknüpfen). Der Nutzer sollte nie fragen müssen "Hat es funktioniert?" oder "Und jetzt?".

Assets (Phase 1 – CLI)

hyperframes figma asset '<url-or-fileKey:nodeId>' [weitere Ref…] [--format svg|png|jpg|pdf] [--scale 2] [--description "..."] [--entity "..."]

Rendert über REST, bereinigt SVG, friert unter .media/images/ ein, hängt das Manifest mit Herkunft an, generiert .media/index.md (das gemeinsame Mediennutzungsverzeichnis) und gibt einen <img>-Snippet aus. Idempotent pro fileKey:nodeId:format:scale:version. Bevorzuge SVG für Vektoren/Logos (skalierbar, animierbar), PNG --scale 2 für Rastertreue. Übergib immer --description "<was es ist>" (es wird zur Indexzeile + <img alt>); füge --entity "<name>" für benannte Markenzeichen hinzu, damit die Mediennutzung resolve --entity sie später findet (Entity-Treffer stimmen über Bild/Symbol überein).

Gruppiere mehrere Knoten in EINER Anfrage – übergib mehrere Referenzen (durch Leerzeichen oder Komma getrennt) derselben Datei: hyperframes figma asset 'KEY:1-2' 'KEY:3-4' 'KEY:5-6'. Alle werden in einem einzigen /v1/images-Aufruf gerendert, was Figmas eigene Antwort auf das Minutenratenlimit ist – bevorzuge dies gegenüber N separaten Befehlen beim Abrufen einer ganzen Frame-Ansammlung von Assets. --description/--entity gelten für jeden Knoten im Batch, also gruppiere Knoten, die einen gemeinsamen Zweck haben. 429 werden automatisch mit Backoff wiederholt.

Tokens (Phase 2 – CLI)

hyperframes figma tokens <fileKey>

Importiert Variablen als Kompositions-Markenvariablen-Einträge + figma-tokens.json-Sidecar + Bindungsindex-Datensätze (.media/figma-bindings.jsonl). Variablen sind Enterprise-seitig eingeschränkt: Bei anderen Plänen fällt der Befehl auf published-style-Metadaten zurück (Werte werden beim Komponentenimport aufgelöst). Füge die gedruckten Einträge zur data-composition-variables der Komposition hinzu.

Importiere Tokens vor Komponenten, wenn beide gewünscht sind – das ermöglicht es Komponentenfarben, sich auf Markenvariablen zu beziehen, anstatt Duplikate zu erzeugen.

Nicht-Enterprise-Variablenpfad (feldgetestet): REST-Variablen sind Enterprise-seitig eingeschränkt, aber ein kompatibler Connector kann Variablendefinitionen bereitstellen. Wenn tokens REQUIRES_ENTERPRISE meldet und der Connector verfügbar ist, rufe die Variablen der übergeordneten Szene einmal ab, cache die Rohantwort in .media/figma-cache/ und verwende sie, um den Bindungsindex zu erstellen. Das REST-Knotenbaum-boundVariables liefert VariableIDs pro Eigenschaft; verknüpfe sie nach Knoten und Eigenschaft und schreibe dann .media/figma-bindings.jsonl-Zeilen ({kind:"binding", figmaId, sourceFileKey, compositionVariableId: "figma:<name>", version}) plus die Kompositionsvariablen-Einträge. Alles Downstream (Komponenten-var()-Auflösung, Aktualisierung, Laufzeit-CSS-Variablen) ist die ausgelieferte Maschinerie. Kennzeichne es für den Nutzer: "Tokens über den Figma-Connector – Enterprise-Pläne erhalten dies direkt von hyperframes figma tokens."

Die Laufzeit definiert jede deklarierte Kompositionsvariable als CSS-Custom-Property (Dokumentstamm + Sub-Comp-Hosts), sodass importierte var(--slug, literal)-Füllungen die Umfärbung aktualisieren, wenn sich der Variablenstandard ändert – das Aktualisieren eines Werts in data-composition-variables brandet jede importierte Komponente neu, ohne etwas erneut zu importieren. hyperframes render --variables '<json>' überschreibt sie zur Renderzeit.

Komponenten (Phase 3 – CLI)

hyperframes figma component '<url-or-fileKey:nodeId>'

Knotenbaum → bearbeitbares HTML in exakter Figma-Geometrie, verpackt als Registry-Element unter compositions/components/<name>/. Vektoren/Boolean-Operationen werden automatisch über Phase-1-Export gerastert. Bindungsdurchlauf (Spezifikation §7.1, nur exakte ID – niemals Wertabgleich):

  • Statische Treue-Selbstprüfung (obligatorisch für Heldeninhalte): nach dem Importieren rendere das Fragment und vergleiche es mit Figmas eigenen Pixeln – figma asset <same node> --format png ist die Grundwahrheit. Text ist die bekannte Abweichungsachse: Ein Figma-Textfeld, das kürzer als seine Zeilenhöhe ist, hat vertikal abgeschnittene Grenzen (der Mapper gibt text-box-trim dafür aus; gemessene Abweichung ohne war ~6px bei einer 70px-Schrift). Wenn der Vergleich eine Abweichung zeigt, die der Mapper nicht abdeckt, melde sie – optimiere das Fragment nicht stillschweigend von Hand.
  • Füllung, die an einen importierten Token gebunden ist → var(--slug, #literal) – Markenaktualisierung propagiert.
  • Gebunden an einen unbekannten Token → literal + data-figma-unresolved-Flag. Der Befehl teilt es dir mit; biete dem Nutzer an: Führe tokens auf der Quell-(oder Bibliotheks-)Datei aus und importiere dann die Komponente erneut, um sie zu verknüpfen. Frage einmal pro unbekannter Bibliothek, um welche Datei es sich handelt – rate niemals, gleiche niemals nach Hex-Wert ab.

Motion (Phase 4 – connector-unterstützt)

Nutzungsbeacon: Connector-unterstützte Phasen haben keinen CLI-Berührungspunkt, daher sende den Skill-Beacon zu Beginn und am Ende (anonym, zustimmungsgesteuert, schlägt nie fehl): npx hyperframes events --skill=figma-motion zu Beginn, npx hyperframes events --skill=figma-motion --event=skill_completed --outcome=success|error wenn fertig. Gleiches für Shader (figma-shaders) und Storyboards (figma-storyboard).

Es gibt kein REST-Äquivalent. Wenn ein kompatibler Connector verfügbar ist, verwende ihn und übergib seine Ausgabe an die reinen Helfer in @hyperframes/core/figma; andernfalls fordere einen nativen Export an:

  1. Rufe den Bewegungskontext für den übergeordneten Frame in einer rekursiven Anfrage ab, nicht einer pro Element. Speichere das rohe JSON neben dem Projekt (.media/figma-cache/), sodass die Neuübersetzung kostenlos ist.
  2. Normalisiere in MotionDocs mit motionContextToDocs(rawResponse, { selectorFor, repeat }) aus @hyperframes/core/figma – transkribiere Keyframe-Nummern niemals von Hand. Der Helfer kodiert die feldgetesteten Dekodierungsregeln mechanisch: Er parst die motion.dev-Snippets (die zuverlässige Kodierung – die CSS-Snippets dehnen Dauern und können widersprechen; sie werden ignoriert), entfernt Loop-Wrap-End-Keyframes (Sub-Millisekunden-Segmente zu Zeiten ≈0,9999→1 sind der sofortige Reset der Schleife, keine erstellte Bewegung – der Wrap wird durch repeat-Neustart realisiert) und bewahrt Bezier-Eases wörtlich. selectorFor muss die IDs aus dem Phase-3-Komponentenimport zurückgeben – leite Selektoren nicht von Knotennamen ab. 2b. Validiere gegen die Grundwahrheit, bevor du es als erledigt bezeichnest – obligatorisch: Exportiere den Wurzelrahmen der Kohorte über den verfügbaren Connector und führe node skills/figma/scripts/verify-motion.mjs --reference <export.mp4> --render <render.mp4> --crop WxH+X+Y aus – es vergleicht Bewegungsenergie-Deltas (statische Importtreue hebt sich auf) und schlägt fehl unter 15 dB minimalem Bewegungs-PSNR (kalibriert: originalgetreu ≈ 20+, abweichend ≈ 5). Miss --crop von den tatsächlichen Kartenkanten des Renderings, rate nicht. FEHLER bedeutet, die Übersetzung zu überprüfen, nicht den Schwellenwert.
  3. motionToGsap(doc) → emitTimelineScript(spec) → füge als <script> nach den GSAP + CustomEase CDN-Tags ein. Pausiert, endlich, registriert auf window.__timelines mit einem literal-Schlüssel.
  4. Nicht übersetzbare Spur (shader-getrieben, nicht unterstützte Eigenschaft, komplexe Masken) → exportiere über den Connector, friere das MP4 ein und bette es als <video class="clip"> ein. Ausnahme: shader-getriebene Spuren – Figmas Exportpfad flacht Shader auf die Grundfarbe ab (siehe Shader unten), daher geht der Shader dort stillschweigend verloren; fordere den Nutzer stattdessen zu einem nativen Figma-Export auf. Sage immer, welchen Pfad du verwendet hast und warum. Benannte Eases außerhalb des abgebildeten Satzes fallen auf linear zurück – die Zuordnungstabelle lebt in motionEase.ts; markiere den Fallback für den Nutzer, wenn er ausgelöst wird.
  5. Führe npx hyperframes check aus, bevor du es als erledigt bezeichnest.

Shader (Phase 5 – meist manuell)

Figmas Connector-Renderpfad führt keine Shader aus (sie werden auf die Grundfarbe abgeflacht), und Shader-Quellcode ist nur für bibliotheksveröffentlichte Stile (kostenpflichtiger Vollzugang) erreichbar. Standardpfad: Fordere den Nutzer auf, den Shader-Frame nativ in Figma zu exportieren (PNG oder Motion-MP4) und dann als Phase-1-Asset/Clip zu importieren. Versuche keine Connector-Pixel-Erfassung eines Shaders – sie wird stillschweigend das Falsche liefern.

Storyboards (Ein ABSCHNITT von Szenenframes → Animation)

Die grundlegende Regel: Storyboard-Frames sind KEYFRAMES, keine Folien. Zwei Frames, die dasselbe Element enthalten, beschreiben den Zustand dieses Elements im Laufe der Zeit – animiere das ELEMENT zwischen den Zuständen; spiele die Frames niemals als eine Sequenz von Standbildern ab. Ein Logo, das in vier aufeinanderfolgenden Frames mit abnehmendem y gezeichnet wird, ist EIN Element, das durch vier Keyframes aufsteigt. Storyboard-Frames hintereinander abzuspielen ist die Fehlerart; die Element-Timelines, die sie implizieren, zu rekonstruieren, ist die Aufgabe.

Storyboard-Dateien folgen einer Grammatik, die du mechanisch parsen kannst – schätze nicht, dekoriere:

  1. Szeneneinheiten: Innerhalb des ABSCHNITTS ist jeder frame-große Knoten eine Szene – sowohl benannte FRAMEs als auch lose vollbildgroße RECTANGLEs (Designer fügen Standbilder direkt in den Abschnitt ein). Filtere nach Größe (≈ Kompositionsseitenverhältnis, z. B. >1400×900), nicht nach Knotentyp oder -name.
  2. Reihenfolge = x-Position (zeilenweise, wenn der Streifen umbricht). Sortiere Szenen nach absoluteBoundingBox.x.
  3. Diff benachbarter Frames in Elementketten – hier lebt die Animation. Gleiche untergeordnete Elemente über aufeinanderfolgende Frames ab: zuerst nach Name (gleicher Name = gleiches Element → tweene sein relatives x/y/w/h zwischen Zuständen), dann nach Geometrieähnlichkeit (ähnliche Größe + Position → wahrscheinlich dasselbe Element, selbst wenn der Name wechselt). Erstelle für jede Kette einen AnimationDoc mit Start-End-Paaren.
  4. Szenenübergreifendes Element-Matching: Ein Element, das in mehreren Szenen vorkommt, ist ein animiertes Element über eine Szenengrenze hinweg. Erstelle eine übergeordnete Timeline, die die Szene-Subtimelines enthält.
  5. Gib die MotionDocs aus (eines pro Elementkette).

Erstelle und injiziere niemals eine statische Diashow – das ist der häufigste Fehler. Wenn nach dem Parsen keine Bewegung entsteht (alle Frames sind identisch), informiere den Nutzer und biete an, stattdessen als statischen Frame zu importieren.

Szenen-Wiederholungen erkennen: Wenn zwei aufeinanderfolgende Frames identische Kinder an identischen Positionen haben, überspringe den zweiten und fahre mit dem dritten fort. Informiere den Nutzer: "Frame X übersprungen – keine Änderung gegenüber Frame Y."

Fehler, die du nicht stillschweigend beheben sollst

ProblemErwartete Reaktion
Abgeschnittener Text (siehe Statische Treue-Selbstprüfung oben)Melde die Abweichung; biete an, die Zeilenhöhe oder den Container im Figma-Editor anzupassen
ÜBERLAPPENDER Text / falsche Ebenen-ReihenfolgeFrage den Nutzer, ob er die Ebenen in Figma neu anordnen möchte, oder ob die aktuelle Reihenfolge beabsichtigt ist
Fehlende Schriftarten (Fallback auf systemweit)"Dieses Design verwendet [Schriftarten], die nicht auf diesem System verfügbar sind. Fallback auf systemweit: [Liste]." Frage den Nutzer, ob er fortfahren oder zuerst Schriften installieren möchte (empfohlen: Aussetzer erwartet)
SVG-Sicherheitsproblem (XSS-Versuch in exportiertem SVG)Breche ab; informiere den Nutzer; biete an, als PNG zu exportieren
Ungültiger Figma-Link (kann nicht analysiert werden, Datei nicht vorhanden, keine Berechtigung)Sage dem Nutzer, was am Link falsch ist; schlage vor, den Link in Figma zu öffnen und zu kopieren
Connector nicht verfügbar für Phase 4/5"Phase 4 (Bewegung) erfordert einen kompatiblen Figma-Connector. Bitte verbinde einen oder exportiere die Bewegung als MP4 aus Figma." Sage genau, was fehlt
Komponente wird außerhalb der Komposition aktualisiert"Die importierte Komponente spiegelt Figma nicht mehr vollständig wider. Möchtest du sie neu importieren? Das wird lokale Optimierungen überschreiben."

gitzone / Konvention

  • Jeder Import erzeugt eine eingefrorene Mediendatei + einen Herkunftseintrag im Manifest.
  • Führe npx hyperframes check aus, bevor du als erledigt meldest – es validiert die Kompositionsstruktur, fehlende Bindungen und hängende Verweise.
  • Erstelle keine Branches, Tags oder Commits – das ist die Aufgabe des Nutzers.
  • Wenn der Nutzer nach einem Playground/Sandbox fragt: compositions/playground/figma-import/<date>.
  • Protokolliere die Anzahl der importierten Elemente, den Speicherort der Ausgabe, die Bindungsstatistiken und die Datenherkunft.
  • Bestätige, dass der Nutzer die Änderungen überprüfen kann, indem er npx hyperframes serve ausführt.

npx hyperframes CLI-Referenz

npx hyperframes figma asset '<url-or-fileKey:nodeId>' [--format svg|png|jpg|pdf] [--scale 1|2|3|4] [--description "..."] [--entity "..."]
npx hyperframes figma tokens <fileKey>
npx hyperframes figma component '<url-or-fileKey:nodeId>'
npx hyperframes check
npx hyperframes serve
npx hyperframes render [--variables '<json>']
npx hyperframes skills update figma
npx hyperframes events --skill=figma-motion [--event=...] [--outcome=...]

Individual skills in this repo

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

1999AZZAR/designer-mcp

SOTA animation and physics heuristic guide using motion.dev

1999AZZAR/designer-mcp

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

1999AZZAR/designer-mcp

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

1999AZZAR/designer-mcp

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

1999AZZAR/designer-mcp

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

1999AZZAR/designer-mcp

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

1999AZZAR/designer-mcp

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1999AZZAR/designer-mcp

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1999AZZAR/designer-mcp

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

1999AZZAR/designer-mcp

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1999AZZAR/designer-mcp

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

1999AZZAR/designer-mcp

Use when building or editing a HyperFrames project that people open in Studio: how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

1999AZZAR/designer-mcp

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

1999AZZAR/designer-mcp

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

1999AZZAR/designer-mcp

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

1999AZZAR/designer-mcp

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Verwandte Skills