Communitygithub.com

alecs5am/ralphy

Installieren und verdrahten von Registry-Blöcken und -Komponenten in HyperFrames-Kompositionen. Verwenden beim Ausführen von `hyperframes add`, Installieren eines Blocks oder einer Komponente, Verdrahten eines installierten Elements in index.html oder Arbeiten mit hyperframes.json. Deckt den add-Befehl, Installationsorte, Block-Subkomposition-Verdrahtung, Komponenten-Snippet-Zusammenführung und Registry-Erkennung ab.

Was ist ralphy?

Diese Fähigkeit ermöglicht es, wiederverwendbare Blöcke und Komponenten aus der HyperFrames-Registry zu installieren und in bestehende Kompositionen zu integrieren. Blöcke sind eigenständige Subkompositionen mit eigenen Abmessungen, Dauer und Zeitleiste, die über `data-composition-src` in eine Host-Komposition eingebunden werden. Komponenten sind Effekt-Snippets ohne eigene Abmessungen, die direkt in das HTML der Host-Komposition eingefügt werden. Die Fähigkeit unterstützt die `hyperframes add`-Befehle, konfiguriert Installationspfade in `hyperframes.json` und behandelt die Verdrahtung von Blöcken mit Attributen wie `data-composition-id`, `data-start` und `data-track-index`. Sie dient auch der Erkennung verfügbarer Registry-Elemente durch Lesen des Registry-Manifests. Diese Fähigkeit ist spezifisch für HyperFrames und hilft Entwicklern, schnell Kompositionen aus modularen Bausteinen zusammenzustellen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Registry

Die Registry stellt wiederverwendbare Blöcke und Komponenten bereit, die über hyperframes add <name> installiert werden können.

  • Blöcke — eigenständige Subkompositionen (eigene Abmessungen, Dauer, Zeitleiste). Werden über data-composition-src in eine Host-Komposition eingebunden.
  • Komponenten — Effekt-Snippets (keine eigenen Abmessungen). Werden direkt in das HTML einer Host-Komposition eingefügt.

Wann diese Fähigkeit verwendet werden sollte

  • Der Benutzer erwähnt hyperframes add, „Block“, „Komponente“ oder hyperframes.json
  • Die Ausgabe von hyperframes add erscheint in der Sitzung (Dateipfade, Zwischenablage-Snippet)
  • Sie müssen ein installiertes Element in eine bestehende Komposition einbinden
  • Sie möchten entdecken, was in der Registry verfügbar ist

Kurzreferenz

hyperframes add data-chart              # einen Block installieren
hyperframes add grain-overlay           # eine Komponente installieren
hyperframes add shimmer-sweep --dir .   # ein bestimmtes Projekt anvisieren
hyperframes add data-chart --json       # maschinenlesbare Ausgabe
hyperframes add data-chart --no-clipboard  # Zwischenablage überspringen (CI/headless)

Nach der Installation gibt die CLI aus, welche Dateien geschrieben wurden und ein Snippet zum Einfügen in Ihre Host-Komposition. Das Snippet ist ein Ausgangspunkt – Sie müssen die Attribute data-composition-id (muss mit der internen Kompositions-ID des Blocks übereinstimmen), data-start und data-track-index hinzufügen, wenn Sie Blöcke verdrahten.

Hinweis: hyperframes add funktioniert nur für Blöcke und Komponenten. Für Beispiele verwenden Sie stattdessen hyperframes init <verzeichnis> --example <name>.

Installationsorte

Blöcke werden standardmäßig in compositions/<name>.html installiert. Komponenten werden standardmäßig in compositions/components/<name>.html installiert.

Diese Pfade sind in hyperframes.json konfigurierbar:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

Vollständige Details finden Sie in install-locations.md.

Verdrahtung von Blöcken

Blöcke sind eigenständige Kompositionen – binden Sie sie über data-composition-src in Ihre Host-index.html ein:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Wichtige Attribute:

  • data-composition-src — Pfad zur Block-HTML-Datei
  • data-composition-id — muss mit der internen ID des Blocks übereinstimmen
  • data-start — wann der Block in der Host-Zeitleiste erscheint (Sekunden)
  • data-duration — wie lange der Block läuft
  • data-width / data-height — Block-Canvas-Abmessungen
  • data-track-index — Ebenen-Reihenfolge (höher = weiter vorne)

Vollständige Details finden Sie in wiring-blocks.md.

Verdrahtung von Komponenten

Komponenten sind Snippets – fügen Sie ihr HTML in das Markup Ihrer Komposition, ihr CSS in Ihren Style-Block und ihr JS in Ihr Skript ein (falls vorhanden):

  1. Lesen Sie die installierte Datei (z. B. compositions/components/grain-overlay.html)
  2. Kopieren Sie die HTML-Elemente in Ihr <div data-composition-id="..."> der Komposition
  3. Kopieren Sie den <style>-Block in die Styles Ihrer Komposition
  4. Kopieren Sie etwaige <script>-Inhalte in das Skript Ihrer Komposition (vor Ihrem Zeitleisten-Code)
  5. Wenn die Komponente eine GSAP-Zeitleisten-Integration bereitstellt (siehe Kommentarblock im Snippet), fügen Sie diese Aufrufe zu Ihrer Zeitleiste hinzu

Vollständige Details finden Sie in wiring-components.md.

Erkennung

Durchsuchen Sie verfügbare Elemente:

# Lesen des Registry-Manifests
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Das registry-item.json jedes Elements enthält: Name, Typ, Titel, Beschreibung, Tags, Abmessungen (nur Blöcke), Dauer (nur Blöcke) und Dateiliste.

Details zum Filtern nach Typ und Tags finden Sie in discovery.md.

Individual skills in this repo

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

alecs5am/ralphy

>- Composition and render craft — assembles scenario.json plus asset-manifest.json into a HyperFrames HTML composition and renders the mp4. Owns timing, transitions, captions, audio mix and ducking, the green zone, the render pipeline, and VO sync. Generates no media of its own. USE WHEN the user asks to "compose the video", "render", "preview", "fix the captions", "mix the audio", "tighten the transitions", "final cut", or edits HyperFrames composition code. TRIGGER (EN): "render it", "compose the video", "captions", "audio mix", "transitions", "final cut", "preview the composition".

alecs5am/ralphy

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

alecs5am/ralphy

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

alecs5am/ralphy

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

alecs5am/ralphy

>- How to make a vivid, character-driven brand POSTER — a single still image, not a video. A generalized overlay on the art-director step: supplies the poster-as-landing architecture (top banner → massive beveled wordmark → chest-up hero photo → scattered vinyl-sticker collage → copy block → thin footer strip), the parameterized slot set (brand, exclamation word, hero, product, palette, original blob glyph, aesthetic register), the model stack (gpt-5.4-image-2 for crisp typography, gemini fallback), and the niche's failure modes. Works for ANY brand and ANY aesthetic the user names — Y2K streetwear, vaporwave, grunge zine, clean DTC — the skill supplies the layout know-how, the user supplies the subject + vibe. USE WHEN the user asks for a poster / flyer / drop poster / "poster-as-landing-page" / brand key-art / album-cover-style still / hype graphic, with no specific existing poster to reproduce. This is a content-niche craft-overlay SKILL (generalized), loaded on top of a poster-format template match — n...

alecs5am/ralphy

>- Compatibility shim for the legacy `/ralphy-remotion` skill name. Use when a saved Claude Code command, old project note, or user request still mentions Ralphy Remotion; redirect the task to HyperFrames and the current Ralphy render playbooks instead of authoring new Remotion code.

alecs5am/ralphy

>- Compatibility shim for the legacy `/remotion-to-hyperframes` skill name. Use when an old project, note, or user request asks to migrate Ralphy Remotion work; translate the intent into the current HyperFrames composition model and follow the editor and HyperFrames playbooks.

alecs5am/ralphy

The full extract → classify → blueprint → de-dup → publish pipeline for a finished `.ralphy/workspaces/<ws>/projects/<id>/`. Reads its `units/*/unit.json` (#069) as the Unit source of truth, then factors the project into ALL FIVE entities — Unit + the four typed blocks Template (structure), Style (look), Recipe (effect/treatment), Asset (reusable media). Applies the recipe-vs-tag split (#082/#083): a candidate is a Recipe only if it carries an extractable artifact (ffmpeg filtergraph / HyperFram

alecs5am/ralphy

>- How to make a realistic AI UGC ad for a product — generalized niche know-how that looks real and doesn't feel AI. A domain overlay on the standard pipeline: supplies the shooting-script shape (timestamp | VO | shot | mannerism), the creator-persona build, the problem-mirror hook, the trust-through-mannerisms rule, and the 9:16 ~15s UGC format defaults. Works for ANY product the user names — their skincare line, a no-name app, a gadget. The skill supplies the know-how; the user supplies the product. USE WHEN the user asks for a UGC ad / creator-style product ad / "make an ad that looks like a real person reviewing my product" / testimonial-style or problem-solution short for TikTok / Reels / Shorts, with no specific existing video to reproduce. This is a niche SKILL (generalized), not a remix TEMPLATE. For "remix this exact ad but swap the product/person", use the remix path (docs/skills-vs-templates.md). For swapping the creator in an existing clip, see /ugc-model-swap.

alecs5am/ralphy

When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' 'ideas to grow,' 'what else can I try,' 'I don't know how to market this,' 'brainstorm marketing,' or 'what marketing should I do.' Use this as a starting point whenever someone is stuck or looking for inspiration on how to grow. For specific channel execution, see the relevant skill (paid-ads, social-content, email-sequence, etc.).

alecs5am/ralphy

Full end-to-end workflow for generating a realistic AI UGC ad for a product. 15-second format. Looks real. Doesn't feel AI.

Verwandte Skills