Communitygithub.com

alecs5am/ralphy

레지스트리 블록과 컴포넌트를 HyperFrames 구성에 설치하고 연결합니다. `hyperframes add` 실행, 블록/컴포넌트 설치, 설치된 항목을 index.html에 연결하거나 hyperframes.json 작업 시 사용하세요. add 명령, 설치 위치, 블록 하위 구성 연결, 컴포넌트 스니펫 병합, 레지스트리 검색을 다룹니다.

ralphy란 무엇인가요?

이 스킬은 HyperFrames 프레임워크의 공식 레지스트리에서 제공되는 재사용 가능한 블록(독립적인 하위 구성)과 컴포넌트(효과 스니펫)를 설치하고 기존 구성에 연결하는 방법을 설명합니다. 'hyperframes add' 명령어를 통해 설치하며, 설치된 각 항목의 유형(블록/컴포넌트)에 따라 index.html에 적절히 연결하는 방법을 안내합니다. 블록은 data-composition-src 속성을 통해 독립된 파일로 포함시키고, 컴포넌트는 HTML/CSS/JS 코드를 직접 복사하여 병합합니다. 또한 hyperframes.json 설정 파일을 통한 설치 경로 변경과 curl 명령어를 이용한 레지스트리 검색 방법도 지원합니다. 주로 HyperFrames를 사용하는 개발자에게 유용하며, Claude Code, Cursor, Codex 등 AI 에이전트에서 실행 가능합니다.

지원 대상~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.

관련 스킬