Communitygithub.com

samyakiasonline-ctrl/hyperframe - HyperFrames Einstiegspunkt

Pflicht-Einstiegspunkt: Lies dies zuerst für jede Anfrage zum Erstellen, Bearbeiten, Animieren oder Rendern eines Videos, einer Animation oder einer Bewegungsgrafik, einschließlich Promos, Erklärvideos, Untertitel-Clips, Titelcards, Overlays, Diashows oder interaktiver Präsentationen, Remotion-Ports oder HyperFrames HTML-Kompositionen.

Was ist hyperframe - HyperFrames Einstiegspunkt?

Die HyperFrames-Kompetenz fungiert als obligatorischer zentraler Einstiegspunkt für alle Anfragen im Zusammenhang mit Videoproduktion und Bewegungsgrafiken innerhalb des HyperFrames-Frameworks. Sie ist als Copilot- oder Agenten-Skill konzipiert, der den Arbeitsablauf anhand von Benutzereingaben wie URLs, GitHub-PRs, Figma-Designs, Text-Briefings oder vorhandenen Projekten intelligent bewertet und lenkt. Die Kompetenz beginnt mit der Überprüfung des Projektzustands und der Nutzungskontingente. Anhand einer Prioritätentabelle leitet sie die Anfrage an die entsprechende spezialisierte Workflow-Datei weiter (z. B. `/product-launch-video` für Webseiten-Promos oder `/general-video` für individuelle Kreationen). Sie behandelt sowohl die Neuerstellung als auch die Bearbeitung bestehender Projekte, verwaltet die CLI-Versionskontrolle und installiert bei Bedarf die erforderlichen Domänen-Skills. Nach der Weiterleitung erstellt die Absichtsschicht eine `BRIEF.md`, die als alleiniges Routing-Artefakt für nachfolgende Workflow-Schritte dient. Diese Skill ist für die Plattformen HyperFrames, Claude Code, Cursor und Codex optimiert und bietet Entwicklern und Inhaltserstellern einen optimierten, deterministischen Pfad von der Idee bis zum gerenderten Video, während sie gleichzeitig die Flexibilität für benutzerdefinierte Bearbeitungen und Kompositionen beibehält.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/skills/hyperframes

In Ihrer bevorzugten KI fragen

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

Dokumentation

Plugin-Installationen: Führe vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn dieser Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen gelten die folgenden Aktualisierungsanweisungen.

HyperFrames Einstiegspunkt

Verbleibende Nutzung prüfen

Führe zu Beginn der Erstellung npx hyperframes usage --json aus. Überprüfe die Nutzung erneut zu wichtigen Meilensteinen des Arbeitsablaufs, z. B. nach dem Entwurf und vor dem Rendern, da sich die Nutzung während des Laufs ändern kann. Lies die verfügbaren Fenster und deren Rückstellzeiten; eine vorherige Abfrage reserviert kein Kontingent. Wenn der Befehl fehlschlägt, nicht verfügbar ist oder status: unknown zurückgibt, melde, dass die Nutzung unbekannt ist, und spekuliere nicht. Stimme Umfang und Workflow-Wahl mit dem Benutzer ab.

HyperFrames rendert Videos aus HTML – eine Komposition ist eine HTML-Datei, deren DOM mit data-*-Attributen die Zeitsteuerung deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Der vollständige Erstellungsvertrag befindet sich in /hyperframes-core; lies ihn, bevor du Kompositions-HTML schreibst. Briefing, Storyboard, Review, Produktion, Versand und Frame-Worker-Verträge befinden sich im references/-Verzeichnis dieses Skills.

1. Vom Projektzustand starten

Wende die erste zutreffende Zeile an; werte keine niedrigeren Zustandszeilen aus:

ZustandAktion
Expliziter Port einer bestehenden Remotion-Quelle zu HyperFramesLies references/routes/remotion-to-hyperframes.md, leite dann direkt an diesen Workflow weiter. Überspringe die Absichtsschicht.
Bestimmte Operation an einem bestehenden HyperFrames-Projekt: inspizieren, diagnostizieren, validieren, Vorschau, rendern, veröffentlichen oder Batch-RenderingFühre nur diese Operation aus. Überspringe die Absichts- und Workflow-Routing; lade /hyperframes-cli und alle erforderlichen Domänen-Skills.
Eine Frage, ein Halt, eine Idee ohne konkrete Änderung oder eine gefühlte Notiz zu einem fertigen Film in einem bestehenden ProjektFolge /hyperframes-studio § 0.
Ein neuer Film, der innerhalb eines bestehenden Projekts angefordert wirdFolge /hyperframes-studio § 5.
Bestimmte Bearbeitung eines bestehenden ProjektsFühre die Bearbeitung durch. Führe die Absichtsschicht nicht aus. Um zu erfahren, was sich auf der Zeitleiste eines Projekts befindet (Spuren, Clips, Start, Ende, was abgespielt wird), führe npx hyperframes timeline [--json] aus, anstatt index.html und jede Unterkompositionsdatei zu lesen.
BRIEF.md existiertLies workflow und flow. Führe diesen Workflow aus; flow: companion wird immer in /general-video ausgeführt. Stelle keine Briefing-Fragen.
Kein Briefing, aber hyperframes.json oder STORYBOARD.md existiertSetze aus Projektdateien und aufgezeichneten Präferenzen fort. Leite den zugehörigen Workflow aus vorhandenen Artefakten ab. Wenn er nicht eindeutig bestimmt werden kann, stelle eine einzige Routing-Frage; führe das Absichtsinterview nicht durch.
Frische ErstellungFühre die Absichtsschicht aus – references/intent-interview.md – leite dann einmalig gemäß § 2 weiter.

Wenn du ein bestehendes Projekt bearbeitest, klammer deine Bearbeitungen mit der Projekthistorie (/hyperframes-cli, Projekthistorie in deinem Zug) ein.

Wenn eine frische Anfrage das Thema oder die Eingabe nicht identifiziert, frage, worum es im Video geht, bevor du weiterleitest. Überprüfe Präferenzen und Rezepte, bevor du etwas fragst (references/intent-interview.md, Schritt 1). Eine figma.com-Eingabe oder ein benanntes Rezept ändert die Aufnahme, nicht die Weiterleitung – der Abschnitt „Anpassen orthogonaler Eingaben" des Interviews behandelt beides.

Halte das CLI des Projekts aktuell

Ein eingerüstetes Projekt fixiert hyperframes@<version> in seinen package.json-Skripten, sodass Renderings reproduzierbar bleiben; die Fixierung wird nie von selbst aktualisiert, und ein fixierter Lauf einer älteren CLI gibt dazu keine Warnung aus. Wenn ein Projekt fortgesetzt wird, dessen Skripte eine Fixierung enthalten, überprüfe einmal vor dem ersten rendern-affektierenden Befehl:

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

Der Test ist schreibgeschützt und meldet die Fixierung gegen die neueste Version; behalte das explizite . – bei älteren CLI-Versionen könnte ein bloßes --project gefolgt von einem anderen Flag dieses Flag als Verzeichniswert interpretieren. Wenn der Test meldet, dass das Projekt zurückliegt – oder jede andere CLI-Ausgabe dies bereits anzeigt (der stderr-Hinweis This project pins hyperframes@… (latest …) oder _meta.updateAvailable: true in einem --json-Ergebnis eines fixierten Skripts) – wende npx hyperframes@latest upgrade --project . an, überprüfe dann mit npx hyperframes check. Eine bestandene Überprüfung bestätigt, dass die Kompositionen des Projekts noch auf der neuen Version validieren – nicht, dass das gerenderte Ergebnis mit dem alten Pin bildidentisch ist –, daher ist ein erfolgreicher Sprung nie still: Nenne die alte und neue Version in der Zusammenfassung des Laufs. Ein Projekt ohne Komposition benötigt keine Verifizierung. Wenn die Überprüfung fehlschlägt, mache die Änderung in package.json rückgängig, fahre mit der fixierten Version fort und melde, auf welcher Version das Projekt bleibt und warum. Handle das Signal, anstatt es an den Benutzer weiterzuleiten; lasse niemals einen aktualisierten Pin unverifiziert.

2. Frische Erstellung weiterleiten

Verwende die erste zutreffende Zeile. Stimme das angeforderte Ergebnis ab, nicht ein beiläufig erwähntes Wort oder Dateityp.

PrioritätAnfrageWorkflow
1Explizit eine bestehende Remotion-Quelle portieren/remotion-to-hyperframes
2Eine Präsentation, Pitch-Deck oder navigierbares interaktives Deck verfassen/slideshow
3Einfache Untertitel zu bestehendem Talking-Head-Material hinzufügen, ohne es zu ändern/embedded-captions
4Gestaltete Grafik-Overlays zu bestehendem Talking-Head-, Interview- oder Podcast-Material hinzufügen, ohne das Material zu ändern/talking-head-recut
5Ein beat-synchronisiertes Video aus einer Musikspur erstellen, ohne Erzählung oder Website-Aufnahme/music-to-video
6Eine explizit kurze, unerzählte, bewegungsfokussierte Einheit erstellen, typischerweise unter 10s/motion-graphics
7Einen GitHub-Pull-Request oder eine Code-Änderung aus einer PR-Referenz erklären/pr-to-video
8Eine Website, Produktseite, App oder ein Unternehmen aus einer URL oder einer seitenbezogenen Kurzbeschreibung vermarkten oder präsentieren/product-launch-video
9Ein Thema, einen Artikel oder Notizen mit erfundenen Bildern erklären, ohne Produkt- oder Website-Aufnahme/faceless-explainer
10Jedes andere benutzerdefinierte Video oder Komposition/general-video

Bevor du die Route finalisierst, lies references/routes/<workflow>.md – eine kleine Datei pro Route: den kanonischen Vertrag für Eingabe/Ausgabe/Auslöser (verfügbar bevor lazy-installierte Workflow-Skills vorhanden sind) plus den Interview-Einstieg dieser Route. Wenn der Kandidat seinen Vertrag nicht erfüllt, setze die Weiterleitung fort, anstatt die Übereinstimmung zu erzwingen. Lies nur die Datei der passenden Route.

Allgemeine Mehrdeutigkeiten auflösen

  • Ein kurzer animierter Titel, Logo-Sting, Statistik-Hit, Diagramm-Hit, Karten-Hit oder eigenständiger Lower-Third ist /motion-graphics, wenn er unerzählt ist und die Bewegung die Botschaft ist. Eine statische Titelcard, erzählte Sequenz, längere Montage 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 „Mach ein Video aus dieser Website" ist /product-launch-video.
  • Bestehendes Material mit Untertiteln wird zu /embedded-captions weitergeleitet; Material mit gestalteten Informationskarten zu /talking-head-recut. Neusynchronisation, Neuordnung, Neufärbung, Neurahmung oder Remix von Material ist eine benutzerdefinierte Bearbeitung und fällt auf /general-video zurück.
  • Eine Musikdatei wählt /music-to-video nur, wenn ihr Beat-Raster das Stück antreibt. Als Hintergrund verwendete Musik überschreibt die themenbezogene Route nicht.
  • „Ich möchte ein Storyboard" ändert den Review-Prozess, nicht den Workflow. Ohne anderes Routing-Signal verwende /general-video. Ein bestätigtes skizziertes storyboard.html kann selbst das angeforderte Ergebnis sein; die Review-Schleife definiert diesen Stoppunkt.
  • Spezialisierte narrative Workflows unterstützen bis zu etwa 3 Minuten und sind am stärksten bei 30–90s. Leite ein deutlich längeres Stück zu /general-video weiter. Die Länge überschreibt niemals einen expliziten Port, ein Deck, Untertitel, Overlay oder musikgesteuertes Ergebnis.

3. Einmal weiterleiten, dann verlassen

Bei einer frischen Erstellung führt die Absichtsschicht (references/intent-interview.md) das gesamte Gespräch – Gedächtnis, Triage, Pitch-Runde, Muss-Eigenschaften, Laufform, Übergabe – und endet mit dem Schreiben von BRIEF.md. Das Briefing ist das einzige Routing-Artefakt, das der Workflow liest; nichts später öffnet diesen Skill oder das Interview erneut. Beantworte jede spätere Frage „Was hat die Route verlangt?" aus BRIEF.md.

4. Workflow installieren und betreten

Bevor du den ausgewählten Workflow liest, installiere oder aktualisiere ihn und die Kern-Domänen-Skills:

npx hyperframes skills update <workflow-name>

Verwende den bloßen Namen ohne /. Wenn der Befehl fehlschlägt, gib den Fehler aus; rekonstruiere den Workflow nicht aus dem Gedächtnis. Alles Weitere zur Installation – die Aufteilung in Kern- vs. Lazy-Skills, was init aktualisiert, Diagnose, CI-Opt-out und die CLI-Fallback-Option – 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-Diagnose/hyperframes-keyframes
Design-Spezifikationen, Konzept, Palette, Typografie, Erzählung, Beat-Planung/hyperframes-creative
Bilder, Symbole, Logos, Audio, Untertitel, Grades, LUTs, wiederverwendbare Medien/media-use
Sprachausgabe-Schnitt, Audio-Effektketten, Automationshüllkurven oder eine Kette/Fader über mehrere Spuren (Submix-Bus)/hyperframes-audio
Init, Lint, Check, Snapshots, Compare, Batch-Render, Studio, Render, Publish oder Diagnose/hyperframes-cli
Registry-Blöcke und -Komponenten/hyperframes-registry
Ein benannter Look, Effekt, Behandlung oder Übergang – CRT-Zeilen, Glitch, Filmkorn, Schimmer-Wisch, Konfetti-Ausbruch – BEVOR du es von Hand baust/hyperframes-registry
Figma-Assets, Token, Komponenten oder Storyboard-Frames als rekonstruierte Bewegung/figma

Ersteller-Bearbeitungsphrasen sind domänenübergreifende Anfragen. Lade jeden Skill, der in der passenden Zeile genannt wird:

Ersteller-AnfrageErforderliche Domänen
......

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

Verwandte Skills