Communitygithub.com

nateherkai/hyperframes-student-kit

HyperFramesのレジストリブロックとコンポーネントをインストールし、コンポジションに配線します。hyperframes addコマンドの実行時や、ブロック・コンポーネントのインストール、インストール済みアイテムのindex.htmlへの配線、hyperframes.jsonの操作時に使用します。

hyperframes-student-kit とは?

このスキルはHyperFramesレジストリを操作するためのものです。HyperFramesは、再利用可能な「ブロック」(独立したサブコンポジション)と「コンポーネント」(エフェクトスニペット)を提供し、`hyperframes add <name>`コマンドでインストールできます。ブロックは`data-composition-src`属性を用いてホストコンポジションに埋め込み、コンポーネントはHTML、CSS、JSを直接貼り付けます。インストール後の配線には`data-composition-id`や`data-start`などの属性設定が必要です。このスキルは、レジストリからのアイテム発見、インストールパスの設定(`hyperframes.json`)、ブロック・コンポーネントの具体的な配線手順をカバーしており、HyperFramesを使ったプロジェクト構成を効率化します。対応プラットフォームはCLI(hyperframesコマンド)およびcurlを用いたレジストリAPIです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/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 8 individual skills — each has its own dedicated page.

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

関連スキル