1仕組みと動作原理
コアメカニズムはローカルCLI（ブロック/コンポーネントをインストールする `hyperframes add` および検出を行う `hyperframes catalog`）です。SKILL.md は独自の実装ではなくCLIの操作マニュアルであり、レジストリソースはデフォルトでGitHub raw上の registry.json を参照します。
skills/hyperframes-registry/SKILL.md
hyperframes add data-chart # install a block hyperframes add grain-overlay # install a component hyperframes add captions # install every block tagged captions
レジストリの場所は設定可能です: '"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry"' (SKILL.md 内の hyperframes.json スニペットより) — CLIはこのソースからブロック/コンポーネントを取得します。
ブロックとコンポーネントは配線方法が異なる2種類のリソースです。ブロックは独自のサイズ、再生時間、タイムラインを持つ独立したサブコンポジションであり、`data-composition-src` + data-composition-id/data-start/data-track-index を介してホストにマウントされます。コンポーネントはサイズを持たないエフェクトスニペットであり、HTML/CSS/JS の3要素を手動でホストにマージする必要があります。
skills/hyperframes-registry/SKILL.md
<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>
SKILL.md には主要属性の意味（data-composition-src のパス、ブロック内部IDと一致必須の data-composition-id、秒単位の data-start/duration、レイヤー階層の data-track-index）が詳述されており、references/wiring-blocks.md および wiring-components.md に完全な手順が示されています。
検出戦略は意図的に「閲覧よりも意図検索を優先」する設計になっています。`catalog --query` のローカル語彙ランキングがデフォルト層であり、`--on-device` は同意の上で33MBのモデルをダウンロードすることでセマンティック層を有効化します。検索自体は外部へデータを一切送信しません（'sends nothing'）。
skills/hyperframes-registry/SKILL.md
Search is local and sends nothing. By default it ranks on vocabulary shared with the item's name, title and description, so it only finds items that reuse your words; `--on-device` ranks by meaning instead, after a one-time model download.
SKILL.md はクエリに英語を使用することを義務付けており（カタログのバイリンガルインデックス、オンデバイスモデルが英語専用）、非英語の場合は 'No searchable words in query' を返します。これは一般的な失敗例を不具合ではなく規約として説明しています。
カタログに存在しない検索ヒットの欠落は、能動的な報告経路として設計されています。`hyperframes feedback --search-miss` は「クエリを外部送信する唯一の経路」であり、明示的に独立したコマンド（語彙/セマンティックのどちらで応答したかを示す --tier 付き）として実行され、評価スコアを含めずに検索語句を報告して貢献の優先度を導きます。
skills/hyperframes-registry/SKILL.md
npx hyperframes feedback --search-miss "<the query you ran>" --wanted "<the move you needed>" --tier on-device
コンテキストには明記されています: 'This is the only path that sends a query anywhere, which is exactly why it is a separate deliberate command rather than something the search does on its own.' — 外部送信はユーザーが予期できる単一のコマンドに厳格に制限されています。
オフラインおよびキャッシュの挙動が明確に定義されています。マニフェストキャッシュは24時間有効で、再検証に失敗した場合は古いマニフェストを継続利用します。ただし `add` の実行時にはファイル取得のため必ずネットワーク接続が必要であり、SKILL ではオフラインインストールの保証を明示的に禁止しています。
skills/hyperframes-registry/SKILL.md
**`add` still needs the network, even for an item you installed yesterday.** Only manifests are cached; the item's actual files are fetched on every install.
CLIが利用できない場合のフォールバックとして、curl の明示的な実行例が記載されています: 'curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json' (SKILL.md)。
アップストリームへのコントリビューションパイプラインが完全に組み込まれています。idea → scaffold → build → validate → preview → PR の全工程が references/contributing.md に記載されており、スターターテンプレート（caption/VFX/component/registry-item.json）は templates.md に用意されています。
skills/hyperframes-registry/SKILL.md
To author a NEW registry item (caption style, VFX block, transition, lower third, or a reusable component) and ship it as an upstream PR — not install an existing one — follow the full idea → scaffold → build → validate → preview → ship workflow in [contributing.md](./references/contributing.md).
SKILL.md の概要には 'authoring a new block or component to contribute upstream (idea → scaffold → validate → PR)' と明記されており、レジストリが利用側と貢献側の双方のインターフェースとなっています。
2コア機能
01単一アイテムのインストール/タグによる一括インストール/ディレクトリ指定/機械可読な出力形式（hyperframes add の各形態）
02意図ベースのカタログ検索およびブラウズフィルタリング（--query/--type/--tag/--json/--human-friendly）
03インストール先のカスタマイズと hyperframes.json のパス設定（blocks/components/assets）
04ブロック接続手順の解説: data-composition-src/ID/start/duration/track-index のセマンティクス
05コンポーネントのサンドイッチ接続解説（HTML/CSS/JS の個別ホストマージ + GSAP タイムライン統合）
06カタログ未ヒット語句のフィードバック報告（feedback --search-miss、外部へ検索語句を送信する唯一の経路）
07アップストリームへの貢献ワークフロー: idea → scaffold → validate → PR およびコンポーネント品質基準（component-quality-bar）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | hyperframes CLI（add/catalog/feedback/init；经 npx 或项目内安装） |
| network | registry 源 |
| network | CLI 不可达时的 raw manifest 回退 |
| network | catalog 语义层模型下载（--on-device，一次性、需同意，约 33MB） |
| network | feedback --search-miss 上报（唯一发送查询的命令） |
| network | CDN 依赖（component/demo 模板引 gsap；contributing 流程示例） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: hyperframes add / npx hyperframes catalog / feedback --search-miss / hyperf
- 网络端点: 外部ネットワークアクセスの宣言: レジストリインストール取得: add のたびに raw.githubusercontent.com/heygen-com/hyperframes からアイテムを取得
- 本地工作目录: ファイルの読み書きと成果物の出力: インストール生成物: compositions/<name>.html (blocks)、compositions/components/<name>.html (c
監査ノート： 通常のネットワーク呼び出しであり、送信先も予測可能です。検索はローカルで完結し通信はゼロ、ネットワーク接続は公式 GitHub raw レジストリ（add 時のファイル取得）、任意の33MBオンデバイスモデルのDL（明示的同意が必要）、明示的な feedback --search-miss による報告（クエリテキストの送信）、および npx による初回公式パッケージ取得に限定されています。認証情報の読み込みやトークンの扱いはありません。留意点として、リモートレジストリのHTMLスニペットを実行可能なコンポジションにマージする際のサプライチェーン信頼性やカスタムレジストリ参照時の信頼性が挙げられますが、通信先はいずれも公式かつ想定内のエンドポイントであるため、より高いリスクではなく yellow レベルと判定されます。
5二重目の独立検証
- [ok] registry 端点与回退 curl 行存在 — SKILL.md registry 配置 JSON（第 36 行附近）与 curl 回退命令原文复核一致。
- [ok] 『搜索零外发』与『feedback 外发』并存无矛盾 — 两段原文同页复核：搜索本地词汇排名不发数据；唯一外发被明示为 feedback 命令。
- [ok] on-device 模型下载规模与同意门槛 — 原文 'it needs a consented 33 MB download, so an agent run is on `words` unless it explicitly opted in' 复核一致。
- [ok] SKILL.md 是否自带可执行脚本（隐藏代码面） — find 实测本技能目录仅 SKILL.md + references/(9) + examples/(2)，零 .mjs/.py——纯文档技能，能力全部来自 hyperframes CLI。
- [discrepancy] 供应链面（远程 HTML 并入宿主执行）是否如实定级 — 首轮草稿曾倾向 blue（仅『本地 CLI』视角）；第二遍重审发现 registry 条目的 HTML/JS 会被安装后并入宿主 composition 执行，且 add 每次联网取文件，属有外发的远程内容信任面，按统一分档『有网络外发按对象分级』定为 yellow 并在 injection_surface 显式说明。
6結論
最適な用途： HyperFrames コンポジション内でカタログのブロックやコンポーネント（データチャート、グレインオーバーレイ、トランジション、字幕スタイルなど）を再利用する必要があるすべての制作セッション、およびカタログに新規アイテムを追加したいコントリビューター（ideaからPRまでの全フローに対応）に最適です。
不向きな用途： オフライン環境でのレンダリングやインストール作業（add はネットワーク接続が必須）、レジストリを必要としない極めてシンプルなコンポジション（まずは hyperframes-core を検討してください）、カタログを検索せずにコンポーネントのスタイルをゼロから手書きしたい探索的セッション（まずは catalog を検索した上で自作してください）には不向きです。
Install Agent-Ready
① Verified Mirror 2026-09-09
Option A · Direct DownloadDownload hyperframes-registry.tar.gz
sha256:
Option B · Copy Guide for Agentf0bfec893d952c12…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit b8328f9573.