Communitygithub.com

alecs5am/ralphy

安裝並將註冊表區塊與元件整合至 HyperFrames 組合中。適合執行 hyperframes add、安裝區塊或元件、將已安裝項目整合至 index.html,或處理 hyperframes.json 時使用。涵蓋 add 指令、安裝路徑、區塊子組合連結、元件片段合併及註冊表探索。

ralphy 是什麼?

此技能支援 HyperFrames 註冊表,可讓使用者安裝並整合可重複使用的區塊(Blocks)與元件(Components)。區塊是獨立的子組合,擁有自己的尺寸、時間長度與時間軸,透過 `data-composition-src` 屬性包含在主組合中;元件則是無自訂尺寸的片段,可直接貼入主組合的 HTML 中。當使用者提及 `hyperframes add`、「區塊」、「元件」或 `hyperframes.json`,或需要將已安裝項目連結至現有組合時,即可啟用此技能。它提供快速參考指令(例如 `hyperframes add data-chart` 安裝區塊)、安裝路徑設定(預設為 `compositions/` 與 `compositions/components/`,可於 `hyperframes.json` 中自訂),以及區塊與元件的詳細整合步驟。此外,支援透過 cURL 瀏覽註冊表清單,並篩選類型與標籤。此技能適用於 Claude Code 等終端機型 AI 代理工具,協助開發者自動化 HyperFrames 組合的建置流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alecs5am/ralphy/tree/HEAD/.agents/skills/hyperframes-registry

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HyperFrames 註冊表

註冊表提供可重複使用的區塊(Blocks)與元件(Components),可透過 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 會顯示已寫入的檔案以及一段可貼入主組合 HTML 的片段。該片段僅為起點 — 連結區塊時,您需要額外加入 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.

相關技能