Communitygithub.com

alecs5am/ralphy

HyperFramesレジストリからブロックとコンポーネントをインストールし、既存のコンポジションに配線します。hyperframes addの実行、ブロックやコンポーネントのインストール、インストールしたアイテムのindex.htmlへの配線、hyperframes.jsonの操作時に使用します。add コマンド、インストール場所、ブロックのサブコンポジション配線、コンポーネントスニペットのマージ、レジストリの検索をカバーします。

ralphy とは?

このスキルは、HyperFramesフレームワーク向けに、再利用可能なブロック(独立したサブコンポジション)とコンポーネント(エフェクトスニペット)をレジストリからインストールし、ホストコンポジションに配線するためのものです。`hyperframes add` コマンドを実行すると、ブロックは `compositions/<name>.html` に、コンポーネントは `compositions/components/<name>.html` にインストールされ、CLIが配線に必要なスニペットを出力します。ブロック配線時には `data-composition-src`、`data-composition-id`、`data-start` などの属性を手動で追加する必要があり、コンポーネントはHTML/CSS/JSスニペットを直接マージします。Claude Code、Cursor、CodexなどのAIエージェントが、ユーザーからの `hyperframes add` 関連の要求や `hyperframes.json` の編集を検出したときにこのスキルが呼び出され、ファイルパスの案内や配線手順の支援を行います。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HyperFrames レジストリ

レジストリは、hyperframes add <name> でインストール可能な再利用可能なブロックとコンポーネントを提供します。

  • ブロック — 独立したサブコンポジション(独自の寸法、期間、タイムラインを持ちます)。ホストコンポジション内で data-composition-src を介してインクルードします。
  • コンポーネント — エフェクトスニペット(独自の寸法は持ちません)。ホストコンポジションのHTMLに直接貼り付けます。

このスキルを使用するタイミング

  • ユーザーが hyperframes add、「ブロック」、「コンポーネント」、または hyperframes.json に言及した場合
  • hyperframes add の出力がセッションに表示された場合(ファイルパス、クリップボードスニペット)
  • インストールしたアイテムを既存のコンポジションに配線する必要がある場合
  • レジストリで何が利用可能かを確認したい場合

クイックリファレンス

hyperframes add data-chart              # ブロックをインストール
hyperframes add grain-overlay           # コンポーネントをインストール
hyperframes add shimmer-sweep --dir .   # 特定のプロジェクトをターゲットにする
hyperframes add data-chart --json       # マシンリーダブルな出力
hyperframes add data-chart --no-clipboard  # クリップボードをスキップ(CI/ヘッドレス)

インストール後、CLIは書き込まれたファイルと、ホストコンポジションに貼り付けるスニペットを出力します。スニペットは開始点です — ブロックを配線する際には、data-composition-id(ブロックの内部コンポジションIDと一致する必要があります)、data-start、data-track-index 属性を追加する必要があります。

注: hyperframes add はブロックとコンポーネントに対してのみ機能します。例については、代わりに hyperframes init <dir> --example <name> を使用してください。

インストール場所

ブロックはデフォルトで compositions/<name>.html にインストールされます。 コンポーネントはデフォルトで compositions/components/<name>.html にインストールされます。

これらのパスは hyperframes.json で設定可能です:

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

詳細は install-locations.md を参照してください。

ブロックの配線

ブロックは独立したコンポジションです — ホストの index.html で data-composition-src を介してインクルードします:

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

主な属性:

  • data-composition-src — ブロックHTMLファイルへのパス
  • data-composition-id — ブロックの内部IDと一致する必要があります
  • data-start — ブロックがホストのタイムラインに表示されるタイミング(秒)
  • data-duration — ブロックの再生時間
  • data-width / data-height — ブロックのキャンバスサイズ
  • data-track-index — レイヤーの順序(大きい値ほど前面)

詳細は wiring-blocks.md を参照してください。

コンポーネントの配線

コンポーネントはスニペットです — そのHTMLをコンポジションのマークアップに、CSSをスタイルブロックに、JSをスクリプト(存在する場合)に貼り付けます:

  1. インストールされたファイル(例: compositions/components/grain-overlay.html)を読み取ります。
  2. HTML要素をコンポジションの <div data-composition-id="..."> 内にコピーします。
  3. <style> ブロックをコンポジションのスタイルにコピーします。
  4. 任意の <script> コンテンツをコンポジションのスクリプト(タイムラインコードの前)にコピーします。
  5. コンポーネントがGSAPタイムライン統合を公開している場合(スニペット内のコメントブロックを参照)、それらの呼び出しをタイムラインに追加します。

詳細は wiring-components.md を参照してください。

検索

利用可能なアイテムを参照:

# レジストリマニフェストを読み取る
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

各アイテムの registry-item.json には、名前、タイプ、タイトル、説明、タグ、寸法(ブロックのみ)、期間(ブロックのみ)、およびファイルリストが含まれています。

タイプとタグによるフィルタリングの詳細は 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.

関連スキル