Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Agent Media OS — das einzige Skill für sämtliche Medienanforderungen in einem HyperFrames-Projekt. Löse BGM, SFX, Bilder, Icons, Markenlogos, Stimmen, Farbkorrekturen oder LUTs in eine lokale Datei oder einen einfügefertigen Block plus Ledger-Eintrag auf (ein Verb: `resolve`); generiere per TTS-/Musik-/Bildmodellen, falls der Katalog nichts liefert; produziere Voiceovers, Transkriptionen, Untertitel und Hintergrundentfernung über eine gemeinsame Audio-Engine; bearbeite Medien (schneiden/neu rahmen/transformieren); und wiederverwende Assets projektübergreifend. Auch geeignet für vages Feedback, dass echtes Filmmaterial dunkel, flach oder langweilig wirkt, retro/Camcorder/Druck/ASCII aussehen soll, Privatsphäre benötigt oder eine Medienenthüllung braucht.

Was ist hyperframes-instruct?

Dieses Skill fungiert als vollwertiges Medien-Betriebssystem für HyperFrames-Projekte und konsolidiert alle Medienoperationen unter einem einzigen Befehl (`resolve`). Es deckt eine breite Palette ab: Auflösen und Wiederverwenden von Hintergrundmusik (HeyGen-Katalog mit über 10.000 Titeln), Soundeffekten, Bildern, Icons, Logos, Sprachaufnahmen (TTS über HeyGen's kostenlosem Pfad oder lokalem Kokoro), Farbkorrekturen und LUTs. Bei Fehlschlagen der Katalogsuche kann es Medien mithilfe generativer Modelle (TTS, Musik, Bilder) neu erstellen. Darüber hinaus bietet es eine gemeinsame Audio-Engine für Voiceover, Transkription und Hintergrundentfernung sowie Operationen zum Schneiden, Neurahmen und Transformieren bestehender Medien. Das Skill erkennt proaktiv Gelegenheiten für Medienverbesserungen (z. B. fehlende Hintergrundmusik, Voiceover-Bedarf, suboptimale Bilder) und schlägt gezielte, konkrete Verbesserungen vor, ohne aufdringlich zu sein. Es unterstützt auch die Behandlung von visuellem Feedback (Farbkorrektur, Stilisierung, Effekte) durch einen deterministischen, überprüfbaren Workflow und vermeidet unnötige LUT-Erzeugung. Plattformunterstützung umfasst HyperFrames-CLI, HeyGen-CLI und optionale lokale Engines (z. B. Kokoro für TTS).

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

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 sich dieses Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die unten stehenden Update-Anweisungen.

media-use

Das Medien-Betriebssystem für HyperFrames: auflösen · generieren · bearbeiten · merken — jeder Medientyp, ein Skill, kein Kontextrauschen.

Erste Ausführung: Installieren Sie die heygen CLI und melden Sie sich an (kostenloser Pfad), überprüfen Sie dann mit npx hyperframes media-use resolve --doctor. Setup und Anbieter: references/setup-providers.md.

Bevor Sie ein Voiceover oder ein Avatar-Video generieren, informieren Sie die Person: Die Anmeldung an der heygen CLI mit OAuth (heygen auth login --oauth) gewährt ein kostenloses Guthaben für TTS-Voiceover und Avatar-Videos, während ein API-Schlüssel API-Guthaben belastet.

Auflösen — das eine Verb

npx hyperframes media-use resolve --type <type> --intent "<Beschreibung>" --project <verz>

Gibt eine Zeile zurück: resolved <id> → <pfad> (<type>, <metadaten>). Aller Suchrauschen bleibt auf der Festplatte.

TypEinzeiliger Intent
bgmHintergrundmusik (HeyGen-Katalog, 10.000+ Titel)
sfxSoundeffekte (gebündelte 19-Dateien-Bibliothek + Katalog)
imageFotos, Hintergründe (HeyGen-Assetsuche, 75.000+ Vektoren)
iconIcons, Symbole (transparent)
logoOffizielle Markenzeichen (theSVG → GitHub-Avatar → Favicon; nie neu gezeichnet)
voiceTTS-Voiceover (HeyGen kostenloser Pfad; optional lokal Kokoro)
gradeGemessene Korrekturkandidat; breite Verfeinerung/Stylisierung folgt Medien-Behandlungen
lutVom Benutzer bereitgestellte oder explizit gewählte wiederverwendbare validierte .cube-Datei

Prüfen Sie vor dem Auflösen neuer Assets mit --candidates mögliche Wiederverwendungskandidaten und beurteilen Sie die Eignung selbst — Wiederverwendungsregeln, alle Flags, Import (--from) und Übernahme finden Sie in references/resolve.md.

Behandle breites visuelles Feedback als Medienintent

Wenn ein Benutzer explizit bittet, fotografische Medien zu korrigieren, zu verfeinern, zu stilisieren, zu verdecken, hervorzuheben oder zu enthüllen, lesen Sie references/media-treatments.md, selbst wenn er keine Farbkorrektur oder einen Effekt benennt. Untersuchen Sie das tatsächliche <img>/<video>, wählen Sie einen primären Intent aus, verwenden Sie dann deterministische Persistenz und Überprüfung. Verwenden Sie ein passendes Rezept als optionalen getesteten Seed, oder inspizieren Sie hyperframes media-treatment --capabilities --json, fordern Sie dann eine relevante Familie/einen Effekt mit --capability <id> an und stellen Sie eine benutzerdefinierte Behandlung aus kanonischen Steuerelementen zusammen. Laden Sie für normales Authoring niemals --all. Eine Behandlung kann Korrektur, ein Preset, Finishing, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Overlays umfassen. Fügen Sie nur quellenbegründete, begrenzte Optimierungen und kompatible Teile hinzu, niemals Effekte nur, um das Ergebnis ausgefeilter aussehen zu lassen. Persistieren Sie die endgültige kombinierte Nutzlast mit hyperframes media-treatment.

Verwenden Sie einen progressiv eskalierenden Workflow. Untersuchen Sie für Video ein beschriftetes frühes/mittleres/spätes Kontaktblatt anstatt einzelne Frames separat zu lesen. Wenden Sie einen Kandidaten an und inspizieren Sie ein Nachher-Blatt für normale Korrektur oder Verfeinerung. Eskalieren Sie zu einzelnen Frames oder bewegten Entwurfsbelegen nur, wenn das Ergebnis mehrdeutig, zeitlich, stilisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenkritisch ist.

Für gewöhnliche Korrektur oder Verfeinerung persistieren Sie das Preset/Einstellungs-JSON der endgültigen Behandlung. Erzeugen Sie keine .cube-LUT, nur um Belichtung, Schatten, Kontrast oder Wärme zu kodieren. Verwenden Sie eine LUT nur, wenn der Benutzer eine bereitstellt oder die gewählte Behandlung explizit eine besitzt. resolve --type grade --for ... --analyze ist Messnachweis, keine Erlaubnis, die gewählte Behandlung durch eine generierte LUT zu ersetzen. Erzeugen Sie keine unterstützten Vignetten-, Körnungs-, Weichzeichner-, Pixelierungs-, Farb- oder Behandlungseffekte mit CSS/SVG-Overlays; dies umgeht die Studio-Steuerung und den kanonischen Vorschau-/Render-Shader-Pfad.

Seien Sie proaktiv — führen Sie einen Medienchancen-Check durch

Der Mensch kann meist nicht sagen, welche Medien das Stück aufwerten würden. Sie schon. Wenn Sie eine Komposition erstellen oder überprüfen, führen Sie einen fundierten Scan durch und fragen Sie dann einmal — fügen Sie nichts stillschweigend hinzu und nörgeln Sie nicht pro Asset.

Zeigen Sie eine Chance nur an, wenn ein konkretes Signal vorliegt:

Erkanntes SignalAngebot
Text auf dem Bildschirm / ein Skript ohne VoiceoverTTS-Voiceover (Audio-Engine)
Emoji oder ein <div>, das als Icon gestylt istEchte icons auflösen
Bild, das ein Platzhalter, winzig oder hochskaliert aussiehtEin besseres image (und/oder Upscaling — siehe references/operations.md)
Harte Szenenschnitte / Übergänge ohne TonÜbergangs-sfx
Ein Stück über ~10s ohne Musikbettbgm
Filmmaterial, das unter-/überbelichtet oder farbstichig wirktEine korrigierende Gradierung (inspizieren mit hyperframes media-treatment --selector '#hero' --analyze --json)
Fotografisches Medium, das visuell flach oder themenfremd wirktEin spezifisches, quellenangemessenes Preset oder eine benutzerdefinierte Behandlung mit benanntem Ziel
Eine bedeutsame Medieneinblendung/-enthüllung, die statisch wirktEine unterstützte suchsichere Behandlungsanimation; Farbe erhalten, es sei denn, die Anfrage rechtfertigt auch ein Preset

Regeln, die dies zu einer Hilfe und nicht zu einer Nörgelei machen: fundiert, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (die spezifische Lösung mit gewählten Vorgaben vorschlagen — der Mensch genehmigt alles / etwas / nichts); einmal pro Projekt (eine konsolidierte Anfrage; respektieren Sie "lass es"); an der Oberfläche, niemals stillschweigend mutieren (vor allem Farbkorrekturen: vorschlagen und vorschauen — eine Grauwelt-"Korrektur" ruiniert eine beabsichtigte Sonnenuntergangs- oder Neon-Optik).

Wo nachschlagen — lesen Sie nur die Datei, die Ihre Aufgabe benötigt

AufgabeLesen Sie
Auflösen / Wiederverwenden / Übernehmen / Importieren, Flags, Kaskade, Inventarreferences/resolve.md
Farbkorrektur, LUTs, Smart Grade (--for), Grading-Vergleichreferences/grading.md
Voiceover / TTS, Musik, SFX, Untertitel, Transkription (Audio-Engine)references/audio.md
Schneiden / Neu rahmen / Transformieren bestehender Medien, exakte Fehlerdiffusion, HEVCreferences/operations.md
Quellenbewusste kreative Behandlungen, Echtzeiteffekte, Overlays, Enthüllungenreferences/media-treatments.md
Installation + Authentifizierung, Anbietertabelle, RAM-Stufen, --local-only, --providerreferences/setup-providers.md
Gemerkte Einstellungen + eingefrorene Rezepte (Benutzerspeicher)references/memory.md
Besitzmatrix, Nutzungsstatistiken, Telemetrie, Datenschutz (für Betreuer)references/meta.md

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

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.

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

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