Communitygithub.com

delorenj/skills

HyperFramesレジストリからブロックとコンポーネントをインストールし、既存のコンポジションに配線します。`hyperframes add` コマンドの実行時や、`hyperframes.json` の操作時に使用します。

skills とは?

このスキルは、HyperFramesレジストリから再利用可能なブロックとコンポーネントをインストールし、既存のコンポジションに統合するための手順を提供します。主に `hyperframes add` コマンドの操作、インストール先の設定、ブロックのサブコンポジションへの配線、コンポーネントスニペットのマージ、レジストリの参照をカバーします。ブロックは独立したサブコンポジション(独自の寸法、持続時間、タイムラインを持つ)で、`data-composition-src` 属性を使ってホストコンポジションに組み込みます。コンポーネントはエフェクトスニペット(独自の寸法を持たない)で、ホストコンポジションのHTMLに直接ペーストします。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントが、ユーザーからの「hyperframes add」や「block」、「component」といったキーワードを含む指示に応じて、インストールから配線までを自動で実行するために設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/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 には、name、type、title、description、tags、dimensions(ブロックのみ)、duration(ブロックのみ)、file list が含まれています。

タイプとタグによるフィルタリングの詳細は discovery.md を参照してください。

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

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.

delorenj/skills

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.

delorenj/skills

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.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

関連スキル