hyperframes-registry

hyperframes-registry スキルの概要

hyperframes-registry でできること

hyperframes-registry スキルは、汎用的なプロンプトよりも迷いを減らしながら、再利用可能な HyperFrames の registry アイテムをインストールし、組み込むのを助けます。hyperframes add <name> の出力を、実際に動く構成へ落とし込むための実務向けスキルで、ブロックを追加する場合も、コンポーネントを統合する場合も、registry に何があるか確認したい場合も使えます。

こんなときに最適

次のような実用的な hyperframes-registry guide が必要なら、hyperframes-registry スキルを使ってください。

• 既存プロジェクトに registry アイテムをインストールしたい
• そのアイテムが block か component か判断したい
• インストール済みファイルを index.html に組み込みたい
• hyperframes.json の path マッピングを読み解きたい
• まだ採用を決める前に registry アイテムを探したい

何が違うのか

このスキルが特に強いのは、インストール先のパス、ファイル種別、統合手順が重要になる場面です。blocks は自立したサブ構成で、独自の dimensions と timeline を持ちます。一方 components は、ホスト側の構成に差し込んで統合する断片です。ファイルを編集する前に、この違いを見極めるのが最重要の判断点であり、そこを明確にしてくれるのがこの hyperframes-registry スキルです。

hyperframes-registry スキルの使い方

まず適切なファイルをインストールして確認する

hyperframes-registry install では、スキルを repository の構成の代わりに使うのではなく、構成と併せて使ってください。まずインストール対象のアイテムを確認し、次のファイルを読みます。

• ワークフロー用の SKILL.md
• registry 検索と manifest フィールド用の references/discovery.md
• デフォルトパスと hyperframes.json の再マッピング用の references/install-locations.md
• アイテム種別に応じた references/wiring-blocks.md または references/wiring-components.md
• エンドツーエンドのパターン確認用の examples/add-block.md と examples/add-component.md

雑な依頼を、使えるプロンプトに変える

良い hyperframes-registry usage は、名前だけではなく具体的な目的から始まります。入力に含めるべき要素は次のとおりです。

• アイテム名
• block か component か
• プロジェクト内の配置先
• 既存の構成に組み込むのか、新規作成なのか
• hyperframes.json での path 再マッピング有無

プロンプトの形の例:
Install data-chart into my HyperFrames project, wire it into index.html, and tell me which files and attributes need updating.

よくあるミスを避けるための手順

信頼できる hyperframes-registry guide は次の流れです。

1. プロジェクト内で hyperframes add <name> を実行する。
2. 書き込まれたファイルと、CLI が出力したスニペットを確認する。
3. アイテムが block か component かを確かめる。
4. block は data-composition-src、data-start、data-duration、data-track-index を使って接続する。
5. component は、スニペットの指示どおり HTML、CSS、JS に統合する。
6. プロジェクトが hyperframes.json#paths を上書きしている場合は、パスを更新する。

実用的な品質向上のコツ

より良い出力を得るには、スキルに「その composition にすでに何があるか」を伝えてください。たとえば、既存の canvas サイズ、timeline の長さ、ホスト側に data-composition-id があるかどうかを明記します。これは hyperframes-registry for Design Implementation では特に重要で、blocks はホストのレイアウトに合わせる必要があり、components は現在の timeline とスタイルに適合していなければならないからです。

hyperframes-registry スキル FAQ

これはインストール作業専用ですか？

ほぼそのとおりです。hyperframes-registry スキルは、install、discovery、wiring の判断に向いています。HyperFrames の概念説明だけが欲しいなら、通常のプロンプトで十分です。実際の file path と統合作業が必要なら、このスキルのほうが適しています。

block と component はどう違いますか？

block は、独自の dimensions と duration を持つ完全な composition で、data-composition-src で埋め込みます。component は、既存の composition に貼り付けるスニペットです。独立したタイミングや別 canvas が必要なら block を選びます。現在の scene に溶け込む効果が必要なら component を選びます。

初心者でも repo を先に理解しておく必要がありますか？

ありません。目的が「このアイテムをインストールして組み込むこと」だと分かれば、このスキルは初心者にも使いやすいです。初心者がやりがちな失敗は、hyperframes add のあとに wiring を省略してしまうことです。repo の参照情報は、次にどこを見ればよいかを正確に示すことで、そのリスクを減らします。

どんなときに使わないほうがいいですか？

HyperFrames registry を扱っていない場合、何かをインストールする段階ではない場合、あるいは編集内容がすでに完全に分かっていて、短いプロンプトの言い換えだけが必要な場合は、hyperframes-registry は使わないでください。インストールの判断と統合の詳細がまだ未確定なときに、最も役立ちます。

hyperframes-registry スキルを改善する方法

足りない制約を最初に渡す

品質を最も大きく上げるのは、hyperframes-registry にターゲットの composition が何を前提にしているかを伝えることです。canvas サイズ、timeline の長さ、インストール先ディレクトリの希望、ホストプロジェクトがデフォルトの compositions/ パスを使っているか、それとも再マッピングしているかを含めてください。これで、パスの不一致や wiring の前提ずれを防げます。

統合作業の接点を具体的に見せる

より良い hyperframes-registry usage のために、ホスト側 composition の該当部分をそのまま貼るか、正確に説明してください。

• index.html の container
• 既存の data-composition-id
• 現在の GSAP timeline の開始時刻
• すでに使っている wrapper 要素や layers

これは block の wiring で特に重要です。配置と layer 順が、追加したアイテムの動作に直結するからです。

最初の出力から詰めていく

最初の結果が惜しいがまだ使えない場合は、次のいずれかを求めて絞り込んでください。

• hyperframes.json に基づく修正済みの install path
• 最小限の wiring スニペットのみ
• 同じ見た目を実現する block-vs-component の推奨
• HTML、CSS、JS の手順を分けた merge plan

このフィードバックループが、初回プロンプトを膨らませすぎずに hyperframes-registry の結果を改善する最短ルートです。