Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Einstiegspunkt für die Erstellung, Bearbeitung, Animation oder das Rendern von Videos, Animationen oder Bewegtgrafiken mit HyperFrames.

Was ist hyperframes-instruct?

Dieses Skill ist der obligatorische Einstiegspunkt für alle Anfragen, die ein Video, eine Animation oder eine Bewegtgrafik mit HyperFrames erstellen, bearbeiten, animieren oder rendern. Es deckt ein breites Spektrum an Outputs ab, darunter Promos, Erklärvideos, untertitelte Clips, Titelcards, Overlays, Diashows, interaktive Präsentationen, Portierungen von Remotion und beliebige HTML-Kompositionen. Der Skill prüft den Projektstatus, erfasst die Absicht des Benutzers (Intent), installiert und wählt den passenden Workflow aus und leitet die Anfrage an die entsprechenden Domänen-Fähigkeiten weiter. Er unterstützt verschiedene Eingabeformate wie Website-URLs, GitHub-PRs, Figma-Designs, Text-Briefings, vorhandenes Filmmaterial oder Musik. Zu den Hauptfunktionen gehören die Verwaltung des Projektstatus, die Durchführung von Intent-Interviews zur Erfassung der Anforderungen anhand von Vorlieben und Rezepten, die Weiterleitung an spezialisierte Workflows (z. B. für Diashows, Musik-Videos oder Code-Erklärungen) und die Installation der erforderlichen Skills. Es stellt außerdem sicher, dass die CLI des Projekts auf dem neuesten Stand ist, und validiert Kompositionen nach Upgrades. Dieses Skill ist als Standard-Output-Framework konfiguriert, es sei denn, der Benutzer wählt explizit ein anderes oder bittet nur um die Aufzeichnung einer Browsersitzung. Der typische Arbeitsablauf umfasst das Prüfen des verbleibenden Nutzungskontingents, das Starten vom Projektstatus, das Weiterleiten von Neuanfertigungen anhand einer Prioritätentabelle und das Installieren des ausgewählten Workflows, bevor domänenspezifische Skills bei Bedarf geladen werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/hyperframes

In Ihrer bevorzugten KI fragen

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

Dokumentation

Plugin-Installation: Führen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn dieses Skill sich in einem HyperFrames-Plugin befindet. Bei eigenständigen Installationen gelten die unten stehenden Aktualisierungshinweise.

HyperFrames Einstiegspunkt

Verbleibende Nutzung prüfen

Führen Sie zu Beginn der Erstellung npx hyperframes usage --json aus. Überprüfen Sie dies erneut bei Workflow-Meilensteinen, z. B. nach dem Entwurf und vor dem Rendern, da sich die Nutzung während des Laufs ändert. Lesen Sie die verfügbaren Fenster und deren Rückstellzeiten aus; ein vorheriges Lesen reserviert kein Kontingent. Wenn der Befehl fehlschlägt, nicht verfügbar ist oder status: unknown zurückgibt, melden Sie, dass die Nutzung unbekannt ist, und raten Sie nicht. Behalten Sie den Umfang und die Workflow-Auswahl mit dem Benutzer bei.

HyperFrames rendert Videos aus HTML – eine Komposition ist eine HTML-Datei, deren DOM das Timing mit data-*-Attributen deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Der vollständige Autorenvertrag befindet sich in /hyperframes-core; lesen Sie ihn, bevor Sie Kompositions-HTML schreiben. Brief-, Storyboard-, Review-, Produktions-, Dispatch- und Frame-Worker-Verträge befinden sich in den references/ dieses Skills.

1. Vom Projektstatus starten

Wenden Sie die erste übereinstimmende Zeile an; werten Sie keine niedrigeren Statuszeilen aus:

StatusAktion
Explizite Portierung einer vorhandenen Remotion-Quelle zu HyperFramesLesen Sie references/routes/remotion-to-hyperframes.md und leiten Sie dann direkt zu diesem Workflow weiter. Überspringen Sie die Intent-Ebene.
Spezifische Operation an einem vorhandenen HyperFrames-Projekt: inspizieren, diagnostizieren, validieren, Vorschau, rendern, veröffentlichen oder StapelrendernFühren Sie nur diese Operation durch. Überspringen Sie Intent und Workflow-Routing; laden Sie /hyperframes-cli und alle erforderlichen Domänen-Skills.
Eine Frage, eine Pause, eine Idee ohne konkrete Änderung oder eine gefühlte Anmerkung zu einem fertigen Film in einem vorhandenen ProjektFolgen Sie /hyperframes-studio § 0.
Ein neuer Film, der innerhalb eines vorhandenen Projekts angefordert wirdFolgen Sie /hyperframes-studio § 5.
Spezifische Bearbeitung eines vorhandenen ProjektsFühren Sie die Bearbeitung durch. Führen Sie nicht die Intent-Ebene aus. Um zu erfahren, was sich auf der Zeitleiste eines Projekts befindet (Spuren, Clips, Starts, Enden, was abgespielt wird), führen Sie npx hyperframes timeline [--json] aus, anstatt index.html und jede Unterkompositionsdatei zu lesen.
BRIEF.md existiertLesen Sie workflow und flow. Führen Sie diesen Workflow aus; flow: companion wird immer in /general-video ausgeführt. Stellen Sie keine Brief-Fragen.
Kein Brief, aber hyperframes.json oder STORYBOARD.md existiertNehmen Sie die Arbeit anhand der Projektdateien und gespeicherten Präferenzen wieder auf. Leiten Sie den zugehörigen Workflow aus vorhandenen Artefakten ab. Wenn er nicht eindeutig bestimmt werden kann, stellen Sie eine reine Routing-Frage; führen Sie kein Intent-Interview durch.
Frisch erstellenFühren Sie die Intent-Ebene aus – references/intent-interview.md – und leiten Sie dann einmalig anhand der Tabelle in § 2 weiter.

Wenn Sie ein vorhandenes Projekt bearbeiten, umschließen Sie Ihre Änderungen mit der Projektverlauf (/hyperframes-cli, Projektverlauf in Ihrem Zug).

Wenn eine frische Anfrage das Thema oder die Eingabe nicht identifiziert, fragen Sie, worum es in dem Video geht, bevor Sie weiterleiten. Überprüfen Sie Einstellungen und Rezepte, bevor Sie etwas fragen (references/intent-interview.md, Schritt 1). Eine figma.com-Eingabe oder ein benanntes Rezept ändert die Aufnahme, nicht das Routing – der Abschnitt „Angepasste orthogonale Eingaben" des Interviews behandelt beides.

Halten Sie die CLI des Projekts aktuell

Ein Gerüstprojekt fixiert hyperframes@<version> in seinen package.json-Skripten, damit Rendering reproduzierbar bleibt; die Fixierung wird nie automatisch aktualisiert, und eine fixierte Ausführung einer älteren CLI gibt keine Warnung dazu aus. Wenn Sie ein Projekt fortsetzen, dessen Skripte eine Fixierung enthalten, prüfen Sie einmal vor dem ersten rende-relevanten Befehl:

npx hyperframes@latest upgrade --project . --check

Die Prüfung ist schreibgeschützt und meldet die Fixierung gegen die neueste Version; behalten Sie das explizite . bei – bei älteren CLI-Versionen verbraucht ein bloßes --project gefolgt von einem anderen Flag dieses Flag als Verzeichniswert. Wenn sie meldet, dass das Projekt zurückliegt – oder eine CLI-Ausgabe dies bereits zeigt (der stderr-Hinweis This project pins hyperframes@… (latest …), oder _meta.updateAvailable: true in einem --json-Ergebnis aus einem fixierten Skript) – wenden Sie npx hyperframes@latest upgrade --project . an und überprüfen Sie dann mit npx hyperframes check. Eine bestandene Prüfung bestätigt, dass die Kompositionen des Projekts mit der neuen Version noch gültig sind – nicht, dass die gerenderte Ausgabe mit der alten Fixierung bildidentisch ist –, daher ist ein erfolgreicher Bump niemals still: nennen Sie die alte und neue Version in der Zusammenfassung des Laufs. Ein Projekt ohne Komposition benötigt keine Überprüfung. Wenn die Prüfung fehlschlägt, machen Sie die Änderung der package.json rückgängig, fahren Sie mit der fixierten Version fort und melden Sie, auf welcher Version das Projekt verbleibt und warum. Handeln Sie aufgrund des Signals, anstatt es an den Benutzer weiterzuleiten; lassen Sie einen erhöhten Bump niemals unbestätigt.

2. Frische Erstellung weiterleiten

Verwenden Sie die erste übereinstimmende Zeile. Ordnen Sie das angeforderte Ergebnis zu, nicht ein beiläufig erwähntes Wort oder Dateityp.

PrioritätAnfrageWorkflow
1Explizite Portierung einer vorhandenen Remotion-Quelle/remotion-to-hyperframes
2Erstellen einer Präsentation, eines Pitch-Decks oder einer navigierbaren interaktiven Präsentation/slideshow
3Hinzufügen einfacher Untertitel oder Bildtexte zu vorhandenem Talking-Head-Material ohne es zu ändern/embedded-captions
4Hinzufügen gestalteter Grafik-Overlays zu vorhandenem Talking-Head-, Interview- oder Podcast-Material ohne das Material zu ändern/talking-head-recut
5Erstellen eines taktsynchronen Videos aus einem Musiktitel, ohne Erzählung oder Website-Erfassung/music-to-video
6Erstellen einer explizit kurzen, unerzählten, bewegungsorientierten Einheit, typischerweise unter 10 s/motion-graphics
7Erklären eines GitHub-Pull-Requests oder einer Code-Änderung anhand einer PR-Referenz/pr-to-video
8Vermarkten oder Präsentieren einer Website, Produktseite, App oder eines Unternehmens anhand einer URL oder standortspezifischen Kurzbeschreibung/product-launch-video
9Erklären eines Themas, Artikels oder von Notizen mit erfundenen Grafiken ohne Produkt- oder Website-Erfassung/faceless-explainer
10Jedes andere benutzerdefinierte Video oder jede andere Komposition/general-video

Bevor Sie die Route finalisieren, lesen Sie references/routes/<workflow>.md – eine kleine Datei pro Route: der kanonische Input/Output/Auslöser-Vertrag (verfügbar, bevor faul installierte Workflow-Skills vorhanden sind) plus den Interview-Eintrag dieser Route. Wenn der Kandidat seinen Vertrag nicht erfüllt, setzen Sie das Routing fort, anstatt die Übereinstimmung zu erzwingen. Lesen Sie nur die Datei der übereinstimmenden Route.

Häufige Mehrdeutigkeiten auflösen

  • Eine kurze animierte Titelsequenz, Logo-Sting, Statistik-Hit, Chart-Hit, Karten-Hit oder eigenständige untere Drittel ist /motion-graphics, wenn sie unerzählt ist und Bewegung die Botschaft ist. Eine statische Titelsequenz, erzählte Sequenz, längerer Zusammenschnitt oder benutzerdefinierte Schleife ist /general-video.
  • Eine explizit kurze Bewegungsgrafik kann eine URL, einen Tweet, einen Artikel oder einen Screenshot als Quellmaterial verwenden. Eine allgemeine Anfrage „Erstelle ein Video von dieser Website" ist /product-launch-video.
  • Vorhandenes Filmmaterial mit Untertiteln wird an /embedded-captions weitergeleitet; Filmmaterial mit gestalteten Informationskarten an /talking-head-recut. Das Neu-Timing, Neu-Anordnen, Neu-Einfärben, Neu-Rahmen oder Neu-Mischen von Filmmaterial ist eine benutzerdefinierte Bearbeitung und fällt auf /general-video zurück.
  • Eine Musikdatei wählt /music-to-video nur aus, wenn ihr Taktgitter das Stück antreibt. Als Hintergrund verwendete Musik überschreibt nicht die themenbezogene Route.
  • „Ich möchte ein Storyboard" ändert den Überprüfungsprozess, nicht den Workflow. Ohne anderes Routing-Signal verwenden Sie /general-video. Ein bestätigtes skizziertes storyboard.html kann selbst das angeforderte Ergebnis sein; die Überprüfungsschleife definiert diesen Stoppunkt.
  • Spezialisierte narrative Workflows unterstützen bis zu etwa 3 Minuten und sind am stärksten im Bereich von 30–90 s. Leiten Sie ein deutlich längeres Stück an /general-video weiter. Die Länge überschreibt niemals ein explizites Portierungs-, Präsentations-, Untertitel-, Overlay- oder musikgesteuertes Ergebnis.

3. Einmalig weiterleiten, dann verlassen

Bei frischer Erstellung führt die Intent-Ebene (references/intent-interview.md) die gesamte Unterhaltung – Gedächtnis, Triage, Pitch-Runde, Must-haves, Lauf-Form, Übergabe – und endet mit dem Schreiben von BRIEF.md. Der Brief ist das einzige Routing-Artefakt, das der Workflow liest; nichts späteres öffnet dieses Skill oder das Interview erneut. Beantworten Sie jede spätere Frage „Was hat die Route verlangt?" aus BRIEF.md.

4. Workflow installieren und betreten

Bevor Sie den ausgewählten Workflow lesen, installieren oder aktualisieren Sie ihn und die Kern-Domänen-Skills:

npx hyperframes skills update <workflow-name>

Verwenden Sie den bloßen Namen ohne /. Wenn der Befehl fehlschlägt, zeigen Sie den Fehler an; rekonstruieren Sie den Workflow nicht aus dem Gedächtnis. Alles andere zur Installation – die Kern-vs.-Faul-Aufteilung, was init aktualisiert, Diagnose, CI-Opt-out und der Fallback ohne CLI – befindet sich in references/skill-lifecycle.md.

5. Domänen-Skills bei Bedarf laden

BedarfSkill
Kompositionsstruktur, Timing-Attribute, Spuren, Variablen, Determiniertheit/hyperframes-core
Bewegungsregeln, Szenen-Blaupausen, Übergänge, Laufzeit-Adapter/hyperframes-animation
Suchsicheres GSAP, CSS, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG, 3D-Keyframes oder hyperframes keyframes-Diagnosen/hyperframes-keyframes
Design-Spezifikationen, Konzept, Palette, Typografie, Erzählung, Taktplanung/hyperframes-creative
Bilder, Icons, Logos, Audio, Untertitel, Grades, LUTs, wiederverwendbare Medien/media-use
Voiceover-Schnitt, Audio-Effektketten, Automationshüllkurven oder eine Kette/Fader über mehrere Spuren (Submix-Bus)/hyperframes-audio
Init, Lint, Check, Schnappschüsse, Vergleiche, Stapelrender, Studio, Rendern, Veröffentlichen oder Diagnosen/hyperframes-cli
Registry-Blöcke und -Komponenten/hyperframes-registry
Ein benannter Look, Effekt, eine Behandlung oder ein Übergang – CRT-Abtastzeilen, Glitch, Filmkorn, Schimmer-Wisch, Konfetti-Ausbruch – BEVOR Sie es selbst erstellen/hyperframes-registry
Figma-Assets, Tokens, Komponenten oder Storyboard-Frames als rekonstruierte Bewegung/figma

Creator-Bearbeitungsphrasen sind domänenübergreifende Anfragen. Laden Sie jedes im übereinstimmenden Zeile genannte Skill:

| Creator-Anfrage | Erforderliche Domänen |


Genauere Angaben folgen in den referenzierten Dateien.

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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, history, clean, 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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and 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`.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Verwandte Skills