Communitygithub.com

Drama2557/4RealDigital-Video-Studio

Agent Media OS: Ein einziger Skill für alle Medienanforderungen in einem HyperFrames-Projekt. Löse BGM, SFX, Bilder, Icons, Markenlogos, Sprachaufnahmen, Farbkorrekturen oder LUTs auf – ein Verb: `resolve`.

Was ist 4RealDigital-Video-Studio?

Dieser Skill fungiert als zentrales Medien-Betriebssystem für HyperFrames-Projekte. Er vereint die Fähigkeiten, Medien aufzulösen (resolve), zu generieren (generate), zu bearbeiten (operate) und projektübergreifend wiederzuverwenden (remember), ohne dass mehrere separate Skills benötigt werden. Der Kernbefehl `node <SKILL_DIR>/scripts/resolve.mjs` ermöglicht die Suche und Einbindung von Hintergrundmusik (BGM), Soundeffekten (SFX), Bildern, Icons, Logos, Sprachaufnahmen (TTS), Farbgradings (grade) und LUTs. Fehlende Assets werden automatisch über TTS-, Musik- oder Bildmodelle generiert. Der Skill erkennt proaktiv Medienmöglichkeiten, z.B. schlägt er Sprachaufnahmen für Bildschirmtexte vor oder verbessert schlechte Bildqualität, und stellt dabei immer eine konkrete, einmalige Anfrage an den Nutzer. Er unterstützt die Plattformen HeyGen (für kostenlose Asset-Nutzung) sowie lokale Engine-Optionen wie Kokoro für TTS. Die vollständige Dokumentation findet sich in den referenzierten Markdown-Dateien im references/-Verzeichnis, die je nach Aufgabe wie Auflösung, Grading, Audio, Operationen oder Einrichtung konsultiert werden sollten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Drama2557/4RealDigital-Video-Studio/tree/HEAD/.agents/skills/media-use

In Ihrer bevorzugten KI fragen

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

Dokumentation

media-use

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

Erster Durchlauf: Installiere und melde dich in der heygen-CLI an (kostenloser Nutzungspfad), überprüfe dann mit node <SKILL_DIR>/scripts/resolve.mjs --doctor. Einrichtung und Anbieter: references/setup-providers.md.

Auflösen — das eine Verb

node <SKILL_DIR>/scripts/resolve.mjs --type <Typ> --intent "<Beschreibung>" --project <Verzeichnis>

Gibt eine Zeile zurück: resolved <ID> → <Pfad> (<Typ>, <Metadaten>). Der gesamte Suchlärm bleibt auf der Platte.

TypEinzeilige Absicht
bgmHintergrundmusik (HeyGen-Katalog, 10k+ Tracks)
sfxSoundeffekte (gebündelte 19-Dateien-Bibliothek + Katalog)
imageFotos, Hintergründe (HeyGen-Assetsuche, 75k+ Vektoren)
iconIcons, Symbole (transparent)
logoOffizielle Markenlogos (svgl → simple-icons → GitHub-Avatar → Favicon; niemals neu gezeichnet)
voiceTTS-Sprachaufnahme (HeyGen-kostenloser Pfad; optional lokales Kokoro)
gradeGemessener Korrekturvorschlag; breite Optimierung/Stylisierung folgt Medienbehandlungen
lutBenutzerbereitgestellte oder explizit gewählte, wiederverwendbare, validierte .cube-Datei

Vor einer Neuauflösung liste wiederverwendbare Kandidaten mit --candidates auf und beurteile die Passung selbst — Wiederverwendungsregeln, alle Flags, Import (--from) und Übernahme findest du in references/resolve.md.

Behandle breites visuelles Feedback als Medienabsicht

Wenn ein Benutzer explizit bittet, fotografische Medien zu korrigieren, zu polieren, zu stylisieren, zu verdecken, hervorzuheben oder zu enthüllen, lies references/media-treatments.md, auch wenn er keine Farbkorrektur oder einen Effekt nennt. Untersuche das echte <img>/<video>, wähle eine primäre Absicht, verwende dann deterministische Persistenz und Verifikation. Verwende ein passendes Rezept als optionalen getesteten Ausgangspunkt oder inspiziere hyperframes media-treatment --capabilities --json, fordere dann eine relevante Familie/einen Effekt mit --capability <ID> an und stelle eine benutzerdefinierte Behandlung aus kanonischen Steuerelementen zusammen. Lade niemals --all für gewöhnliches Authoring. Eine Behandlung kann Korrektur, ein Preset, Finish, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Overlays umfassen. Füge nur quellgerechtfertigte begrenzte Anpassungen und kompatible Teile hinzu, niemals Effekte nur, um das Ergebnis ausgefeilter aussehen zu lassen. Persistiere die endgültige kombinierte Nutzlast mit hyperframes media-treatment.

Verwende einen schrittweise eskalierenden Arbeitsablauf. Untersuche für Video einen beschrifteten frühen/mittleren/späten Kontaktbogen, anstatt Frames einzeln zu lesen. Wende einen Kandidaten an und untersuche einen Nachbogen für gewöhnliche Korrektur oder Optimierung. Eskaliere zu einzelnen Frames oder bewegten Entwurfsbelegen nur, wenn das Ergebnis mehrdeutig, zeitlich, stylisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenkritisch ist.

Für gewöhnliche Korrektur oder Optimierung persistiere das Preset/Anpassungs-JSON der endgültigen Behandlung. Generiere keine .cube-LUT, nur um Belichtung, Schatten, Kontrast oder Wärme zu kodieren. Verwende eine LUT nur, wenn der Benutzer eine bereitstellt oder die gewählte Behandlung explizit eine besitzt. resolve --type grade --for ... --analyze ist ein Messbeleg, keine Erlaubnis, die gewählte Behandlung durch eine generierte LUT zu ersetzen. Erstelle keine unterstützten Vignetten-, Körnungs-, Weichzeichnungs-, Pixelierungs-, Farb- oder Behandlungseffekte mit CSS/SVG-Overlays; das umgeht die Studio-Steuerelemente und den kanonischen Vorschau-/Render-Shader-Pfad.

Sei proaktiv — führe einen Medien-Chancen-Durchlauf durch

Der Mensch kann normalerweise nicht sagen, welche Medien das Stück aufwerten würden. Du schon. Wenn du eine Komposition erstellst oder überprüfst, führe einen fundierten Scan durch und frage dann einmal nach — füge nichts stillschweigend hinzu und belästige nicht pro Asset.

Zeige eine Chance nur an, wenn ein konkretes Signal vorhanden ist:

Erkanntes SignalAngebot
Text auf dem Bildschirm / ein Skript ohne SprachaufnahmeTTS-Sprachaufnahme (Audio-Engine)
Emoji oder ein <div>, das wie ein Icon gestylt istLöse echte icons auf
Bild, das ein Platzhalter, winzig oder hochskaliert aussiehtein besseres image (und/oder hochskalieren — siehe references/operations.md)
Harte Szenenschnitte / Übergänge ohne TonÜbergangs-sfx
Ein Abschnitt über ~10s ohne Musikbettbgm
Material, das unter-/überbelichtet oder farbstichig wirkteine korrigierende Grading (untersuche mit hyperframes media-treatment --selector '#hero' --analyze --json)
Fotografische Medien, die visuell flach oder themenfremd wirkenein spezifisches, quellgerechtes Preset oder eine benutzerdefinierte Behandlung mit genanntem Ziel
Ein bedeutungsvoller Medieneintritt/-auftakt, der statisch wirkteine unterstützte suchsichere Behandlungsanimation; Farbe erhalten, sofern die Anfrage nicht auch ein Preset rechtfertigt

Regeln, die dies zu einer Hilfe machen, nicht zu einer Belästigung: fundiert, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (schlage die spezifische Lösung mit gewählten Standardwerten vor — der Mensch stimmt allen / einigen / keinen zu); einmal pro Projekt (eine konsolidierte Anfrage; respektiere „Lass es“); anzeigen, niemals stillschweigend mutieren (besonders Farbkorrekturen: Vorschlagen und in der Vorschau anzeigen — eine Grauwelt-„Korrektur“ ruiniert einen gezielten Sonnenuntergangs- oder Neon-Look).

Wo nachschlagen — lies nur die Datei, die deine Aufgabe benötigt

AufgabeLese
Auflösen / Wiederverwenden / Übernehmen / Importieren, Flags, Kaskade, Inventarreferences/resolve.md
Farbkorrektur, LUTs, Smart Grade (--for), Grade-Vergleichreferences/grading.md
Sprachaufnahme / TTS, Musik, SFX, Untertitel, Transkription (Audio-Engine)references/audio.md
Schneiden / Neu einrahmen / Transformieren vorhandener Medien, exakte Fehlerdiffusion, HEVCreferences/operations.md
Quellbewusste kreative Behandlungen, Echtzeiteffekte, Overlays, Enthüllungenreferences/media-treatments.md
Installation + Authentifizierung, Anbietertabelle, RAM-Stufen, --local-only, --providerreferences/setup-providers.md
Gespeicherte Präferenzen + eingefrorene Rezepte (Benutzerspeicher)references/memory.md
Eigentumsmatrix, Nutzungsstatistiken, Telemetrie, Datenschutz (für Betreuer)references/meta.md

Individual skills in this repo

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

Drama2557/4RealDigital-Video-Studio

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

Drama2557/4RealDigital-Video-Studio

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

Drama2557/4RealDigital-Video-Studio

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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

Drama2557/4RealDigital-Video-Studio

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

Drama2557/4RealDigital-Video-Studio

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

Drama2557/4RealDigital-Video-Studio

Install, discover, and wire registry blocks and components into HyperFrames compositions. 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).

Drama2557/4RealDigital-Video-Studio

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

Agent skill / project related to launch or product demo video: Drama2557/4RealDigital-Video-Studio

Verwandte Skills