Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFramesレジストリからブロックとコンポーネントを検索、インストール、配線します。CRTスキャンライン、グリッチ、色収差、フィルムグレインなどの名前付きビジュアルエフェクトや、チャート、コードウィンドウ、地図、紙吹雪などのUI要素を手作りする前に、まずこのスキルを使用してください。

hyperframes-instruct とは?

このスキルは、HyperFramesプロジェクトにおけるブロック(独立したサブコンポジション)とコンポーネント(エフェクトスニペット)の検索、インストール、配線を効率化します。レジストリには約400のホステッドアイテムが含まれており、プロジェクトやアカウントがなくても、CLIの`catalog --query`コマンドで意図に基づいたセマンティック検索が可能です。インストールは`hyperframes add <name>`で行い、ブロックは`data-composition-src`属性でホストコンポジションに、コンポーネントはHTML/CSS/JSを直接貼り付けて配線します。検索結果が要件に合わない場合は`hyperframes feedback --search-miss`でギャップを報告し、レジストリの改善に貢献できます。また、新しいブロックやコンポーネントを上流にコントリビュートするためのワークフロー(アイデア→スキャフォールド→検証→PR)もサポートしています。

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

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

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

ドキュメント

プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合はプラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を保持します。

HyperFramesレジストリ

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

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

クイックリファレンス

hyperframes add data-chart              # ブロックをインストール
hyperframes add grain-overlay           # コンポーネントをインストール
hyperframes add captions                # captionsタグが付いたすべてのブロックをインストール
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 — スタジオタイムラインの行。表示のみ。レイヤリングにはCSSのz-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 を参照してください。

ディスカバリー

CLIを主要なディスカバリーサーフェスとして使用します。ブラウジングする前に意図で検索してください: レジストリには目でスキャンできるよりも多くのアイテムが含まれているため、リスト表示して名前やタグでマッチングするのは遅い方法であり、作成者の表現とあなたの表現が異なる場合には失敗します。

# カタログ全体をビートがすべきことに対してランク付け
npx hyperframes catalog --query "reveal a headline one line at a time"
npx hyperframes add caption-clip-wipe

検索はローカルで行われ、何も送信しません。デフォルトでは、アイテムの名前、タイトル、説明と共有される語彙に基づいてランク付けされるため、あなたの言葉を再利用するアイテムのみが見つかります。--on-device は、一度だけモデルをダウンロードした後、意味に基づいてランク付けします。--json を使用すると、エンベロープはどのティアが回答したかを示すので、ランク付けが行われたと想定するのではなく、それを確認してください。

ビデオの言語に関係なく、常に英語でクエリを実行してください。 カタログは英語で書かれており、両方のティアがそのようにインデックスを作成しています(オンデバイスモデルも英語のみです)。別のスクリプトでのクエリは検索可能な用語を生成せず、何も返しません。これは、ブリーフ、キャプション、ナレーションがすべてその言語であり、クエリが自然にそれに従う日本語や中国語のプロジェクトでは誤解しやすいです。動き を英語で説明し、画面上のコピーをビデオが必要とする言語で記述してください。クエリが No searchable words in query を返す場合、これは不足しているコンポーネントではなく、このルールが原因です。そのため、ギャップレポートの価値はありません。

インストール可能性はランク付けの後に適用され、その前ではありません。ベクターが運ぶがこのレジストリが提供できない名前は結果から除外され、dropped にカウントされます。したがって、非ゼロの dropped は両者が異なる世代であることを意味します。オフラインティア、同意ゲート、および古いインデックスを更新する方法については /hyperframes-cli を参照してください。

検索ではなくブラウズまたはフィルタリングするには:

npx hyperframes catalog
npx hyperframes catalog --type block
npx hyperframes catalog --type component
npx hyperframes catalog --type block --tag social
npx hyperframes catalog --json
npx hyperframes catalog --human-friendly

通常のテーブルモードと --json モードは一致のみをリストします。選択した名前を hyperframes add <name> でインストールします。--human-friendly はインタラクティブピッカーを開き、選択したアイテムをすぐにインストールします。CIやエージェントワークフローでは、--json の後に明示的な add を使用することを推奨します。

カタログにないものを報告する

検索結果に該当するものがなく、手動で動きを作成する必要がある場合は、その前に次のように言及してください:

npx hyperframes feedback --search-miss "<実行したクエリ>" --wanted "<必要な動き>" --tier <回答したティア>

catalog --query は事前に入力されたこの行を出力し、--json はそれを report_gap として保持します。そのため、何も合わないと判断した時点で既に手元にあります。

どちらのティアでも、結果に該当するものがない場合には必ず報告してください。 オンデバイスティアが回答するのを待ってはいけません。同意を得た33 MBのダウンロードが必要なため、明示的にオプトインしない限り、エージェント実行は words で行われます。on-device でゲートすると、ほとんどすべての報告が沈黙します。--tier 値が一緒に送られるため、語彙ミスと意味ミスが区別可能になります。想像したアイテム名ではなく、必要だったエフェクトを記述してください。返ってくるのは構築する価値のある動きのリストであり、存在しないアイテムを指定する報告は何も教えません。これがクエリをどこかに送信する唯一のパスであり、それが検索が自動的に行うのではなく、別個の意図的なコマンドである理由です。評価を含まず、評価指標に決して反映されません。

これがカタログ全体の需要シグナルです。これをスキップすると、直面したギャップはインストールカウントから推測されることになり、誰もインストールできない動きを見ることはできません。

CLIが設定されたレジストリに到達できない場合、フォールバックとして生のマニフェストを検査します:

curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

CLIが到達できないレジストリは、ディスカバリーのためにカタログを空にしません。以前にフェッチされたマニフェストは、再検証に失敗した場合でも24時間の更新ウィンドウを過ぎて提供され続けるため、catalog と catalog --query はディスク上の最後のコピーに対してリスト表示およびランク付けを続けます。

昨日インストールしたアイテムであっても、add はネットワークを必要とします。 マニフェストのみがキャッシュされます。アイテムの実際のファイルはインストールのたびにフェッチされます。したがって、オフラインでは検索でき、アイテムが何であるかを確認できますが、インストールはファイルフェッチで失敗します。ユーザーにオフラインインストールを約束しないでください。

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

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

新しいブロックまたはコンポーネントのコントリビュート

新しいレジストリアイテム(キャプションスタイル、VFXブロック、トランジション、ローワーサード、または再利用可能なコンポーネント)を作成し、上流にPRとして送信するには — 既存のものをインストールするのではなく — contributing.md にある完全なワークフロー(アイデア → スキャフォールド → ビルド → 検証 → プレビュー → 出荷)に従ってください。コピーペースト可能なスターターテンプレート(caption / VFX / component / registry-item.json)は templates.md にあります。

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

sandeshrajbhandari/hyperframes-instruct

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

sandeshrajbhandari/hyperframes-instruct

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

sandeshrajbhandari/hyperframes-instruct

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

関連スキル