コンテンツ制作 · heygen-com/hyperframes-community-skills

vox-explainer

一見ありふれたテーマ、または提供されたドキュメントやリンクから、コラージュスタイルの60〜90秒のHyperFrames解説動画を作成します。「身近な物事の解説を作って」「XのVox風の歴史」「なぜXはどこにでもあるのか?」「このドキュメントを解説動画にして」といったリクエストに使用します。トピックまたはソースのルーティング、リサーチ、スクリプト作成、静的デザイン承認、ナレーションのタイミング調整、モーションの連続性、ビルド、数値品質ゲートをカバーします。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ネットワーク通信ファイル書き込みDual-pass Audit
Author heygen-comGitHub heygen-com/hyperframes-community-skills ↗Stars 156License Apache-2.0(仓库根 LICENSE)Commit ba7a0bb6d3
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

2つの入口は1つのゲートを共有します。topicモードでは4問フィルターは選題と取捨選択にのみ使用され、ユーザーが指定したテーマを拒否してはなりません(不合格の箇所、生じる損失を説明し、代替案を提示する)。sourceモードではフィルターは一切適用されず、ユーザー素材をすべて読み込んだ上で「ストーリーライン鉱脈」を実行します。ソース素材をアウトラインではなく鉱山として扱い、on-ramp / tension / turn / mechanism / receiptsの5要素を抽出します。複数ソース・複数ラインがあっても背骨となる主軸は1本のみを選択し、残りはreceiptsに格下げします。

skills/vox-explainer/SKILL.md
- **Topic mode** (the user names a subject, or asks for ideas): the four-part filter governs IDEATION and tie-breaking only.
ここで行っていること:「ユーザーから与えられた題材」と「エージェントが語りたい題材」を切り離して処理し、フィルターが依頼拒絶ツール化するのを防ぎます。sourceモードのcut-don't-fakeルール(実証できないビートは削る)は構造の背骨セクションに規定されています。

構造の背骨は厳格なウェイト配分表です:FAMILIAR 15% → DIG(人物名+日付を明記)5% → STORY 15% → ARTIFACT 10% → MECHANISM(視聴者が画面上で即座に検証可能)20% → SECOND WIND 15% → THESIS(黄色い丸)10% → CLOSE 10%。THE FAMILYは新規ビートではなくFAMILIARの後半に属します。

skills/vox-explainer/SKILL.md
FAMILIAR 15% → DIG (person + date named) 5% → STORY 15% → THE ARTIFACT BEAT 10% → MECHANISM the viewer verifies on screen 20% → SECOND WIND (a technology removes a constraint) 15% → THESIS in the yellow circle 10% → CLOSE mirrors the open 10%.
ここで行っていること:「Vox風味」を測定可能な時間配分へと分解し、MECHANISMに最大の比重を置いています。動画の説得力はナレーションの断定ではなく、目に見える実証デモの上に成り立ちます。

デザインパスでは、まずコンタクトシート(ビートごとに1フレーム、960×540タイル、HTML → ヘッドレスChromeスクリーンショット)を納品し、納品前にLOOK GATEセルフチェックを実施します。カラーパレットは公式に計測された固定値(ink #1a1a1a / yellow #FFE619 / process blue #66CFFF / specimen blue #58BCEC / greys / ground #fbfaf8)を用い、見出しはArchivo Black、各フレームは命名済みrecipeに準拠し、黄色の丸を反復する視覚媒体として使用します。この段階での修正は完成後の修正に比べてコストが10分の1で済みます。また、汚染防止ルールとして、ソースドキュメントに独自のブランド体系がある場合でも無批判に継承してはなりません(brand-faithfulは別ワークフローです)。

skills/vox-explainer/SKILL.md
Iterate here — it is 10x cheaper than comp notes.
ここで行っていること:美的判断を事前に検証可能なチェックリスト(カラーコード、フォント、recipe名)へと落とし込み、「コンタクトシートを先にユーザーへ提示する」ことで制作半ばでの方向性の狂いを未然に防ぎます。

音声クロック:VOは先行録音またはTTSで生成します(TTS入力は発音用スクリプトとして記述:数字はスペルアウト、固有名詞は読み通りに記述)。その後、文字起こしにより単語レベルのタイムスタンプを取得します。以降のすべてのカット、ポップアップ、ハイライトは単語のタイミングに同期され、VOの差し替えは動画全体の再タイミング調整を意味します。字幕はスクリプトファイルではなく「実際に発声された音声」から書き起こされます。

skills/vox-explainer/SKILL.md
Transcribe the result for word timestamps — audio is the clock; every cut, pop, and highlight keys to a word time.
ここで行っていること:音声を先に確定させ、映像を音声に追従させます。これは「カット編集はシームを再オープンする(edits re-open the seam)」という規律の根拠でもあります。

シーム(seam)はこのスキルの核心メカニズムであり、「生成+検証」の2点構成です。まずledger.jsonを記述し(1シーム1行:カット秒、exit/entryの軸+方向、動きを担うセレクタ、テクニック)、seam-stamp.mjsを用いてマスターシームコードをindex.html(// <seams:auto>ブロックを置換)に刻印します。その後seam-gate.mjsで数値検証を行います。ledger行の一致、カット点でexitが静止せず動作中であること、entryが静止状態から開始しないこと、実測方向とledgerの一致、entry/exit速度の一致(WARN)、ゼロオーバーラップ(同一フレームで片側のみ可視、ディゾルブ不可)、Z符号(両側でscale変化の方向が一致し、incomingシーン自体の入場による符号反転がないかスキャン)、キャリア境界の矩形連続性(祖先のscaleを含め、許容誤差12px/5%)。

skills/vox-explainer/references/motion-continuity.md
The script (usage + ledger schema: [seam-gate.md](seam-gate.md)) numerically enforces, per seam: ledger-row consistency, exit still moving at the cut, entry mid-flight (never from rest), measured direction = ledger direction, entry/exit speed match (WARN), **zero overlap** (one side visible per frame — the cut is not a dissolve), the **Z sign** rule
ここで行っていること:「シームが滑らかか」を感覚から測定可能な数値へと変換します。スクリプトはgetBoundingClientRect(x/yは中心、zは幅比率)でサンプリングするため、外側ラッパーの変形も自動計算されます。またprobe --t <cut>で真のキャリアを特定できます。

スライド化防止の基準値と技術宣言:各ビートはビートマップの段階でレイアウトrecipeとモーション手法を**宣言**しなければなりません(動画ビルド時の即興は禁止)。動画全体で最低基準をクリアする必要があります(キャリアをプッシュして突き抜ける換景zoom-isolation ≥1回、解決編の演出に用いるinverse zoom-through ≥1回、全画面で収まるdrive-past/scale traversal ≥2回、平面カードでは不可能な動きを行う背景切り抜きカットアウト ≥1回、newsprint layeringとcircle reveal ≥1回)。また厳格な上限も設定されています(静止カード/左右分割は最大でも3ビートに1回まで、隣接ビートで同一recipe・同一手法の連続禁止)。

skills/vox-explainer/SKILL.md
- CAPS: static-card / side-by-side layouts ≤ one third of beats; no two consecutive beats share the same layout recipe or the same treatment.
ここで行っていること:「プレゼンスライドに見せない」ための工夫を監査可能な分布表に落とし込みます。基準値とzoom-inの制約が衝突した場合は制約を優先することも規定されています。動機のない手法を増やすより、手法が1つ欠けるほうが軽微な欠陥とみなされます。

2コア機能

012種類の入口ルーティング:topicモード(4問フィルターを選題のみに使用)とsourceモード(全素材読み込み+ストーリーライン鉱脈の抽出)。スクリプト執筆前にビートマップの提示とユーザー承認が必須
02スクリプト規律:全文章が削除テストを通過し、オープナー/クロージャーのルールを遵守。ナレーションで素材の出典元を名指しせず、sourceモードでは元資料の想定読者を視聴者として設定
03完全数値QCゲート(強制):lint/checkエラー0件、完成動画に対するフレームごとのMAD静止時間スキャン、シーム数値測定、ビート内イベント間隔の上限、構図の完全性個別監査、キーフレームシートの目視確認
04シーム生成+検証の2点セット(ledger → stamp → gate)。受け入れ基準にはゼロオーバーラップ、Z符号スキャン、キャリア連続性を含む
05実物素材優先:パブリックドメインのアーカイブ(Wikimedia Commons API、LOC)とユーザー提供の実物のみを使用。スキャン欠損時はrecreationと明記
06制御可能な音声収録:公式CLIのローカルTTSを優先し、失敗時はespeak-ngからKokoro+キャッシュ済みモデルを直接呼び出し。サードパーティ製TTS/文字起こしAPIの利用はユーザーの事前承認(プロバイダー/データ/認証情報/コスト)が必須
07成果物の境界:ユーザー指定のプロジェクトディレクトリ内へのみ書き込み、自動公開やアップロードは非実行

3外部依存関係

KindDependency / Endpoint
cliHyperFrames 预览服务(版本钉在脚本常量里:0.8.14;--project 模式下由 npx 拉起,未缓存时会从 npm 下载;可改用 --url 复用已在跑的服务)
cli上游脚手架/技能安装:npx skills add heygen-com/hyperframes、npx hyperframes init
cliNode 22+ 与本地 Chrome/chrome-headless-shell(verifier 自找 Puppeteer 缓存或系统 Chrome,用隔离临时 profile)
networksource 模式会抓公开引用与公共领域/开放许可资产(最多一跳公开引用),资产来源为 Wikimedia Commons API、LOC 等声明的来源
api可选的第三方 TTS / 转写 API(须先向用户说明 provider、数据、所需凭据与可能成本并获得批准)
network预览期仍可能加载构图自身声明的远端资产(verifier 只把 --url/--comp-url 限制为 localhost,不限制页面内的远端引用)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • scripts/: ローカルスクリプトまたはコマンドの実行: node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.
  • 网络端点: 外部ネットワークアクセスの宣言: registry.npmjs.org: --projectモード時にnpx経由でバージョン固定されたHyperFramesプレビューサービスを起動(未キャッシュ時はダウンロード);npx ski
  • 本地工作目录: ファイルの読み書きと成果物の出力: ユーザープロジェクトディレクトリ内: index.html(// <seams:auto>ブロックのみ置換)、プロジェクトソースコード、ダウンロードしたアセット、audio/、コンタクトシート、r
監査ノート: 判定対象=スキル自身のディレクトリ(SKILL.md + scripts/seam-{gate,stamp}.mjs + リファレンス×11)。スキル自体の認証情報読み取りはゼロ:seam-gate.mjsはホワイトリストでサブプロセス環境を構築しpreviewEnv()でフィルタリングを行い、process.envを丸ごと透過させません。seam-stamp.mjsはプロジェクト内のindex.htmlのみを読み書きし、シンボリックリンクを拒否します。黄判定の根拠は実行時のネットワーク接続です。--projectモードではnpxを用いてバージョン固定(0.8.14)のプレビューサービスを起動し、未キャッシュ時はnpmレジストリからダウンロードします。sourceモードでは公開リファレンスやパブリックドメインのアーカイブ(Wikimedia Commons API、LOCなどの宣言済みソース)を取得しますが、これらは固定・公開・予測可能なエンドポイントです。なお、第4バッチ基準に基づき判定に影響しないパスが2点あります:① オプションのサードパーティTTS/文字起こしAPIは「ユーザーの明示的な事前承認を要する代替手段」に該当し(プロバイダー/データ/認証情報/コストの事前提示が規律化されている)、完全ローカルのフォールバック(hyperframes tts / espeak-ng + Kokoroキャッシュモデル)が用意されています。② プレビュー生成時の外部アセット参照は成果物フェーズの動作とみなされます。TLSダウングレード、検知回避、大量データ収集、任意コード実行の余地は見られません。万が一ユーザーがサードパーティTTSを承認し、原稿や認証情報を外部サービスに引き渡した場合は実質的にオレンジ相当の要件となるため、個別のリスク評価が必要です。

5二重目の独立検証

  • [ok] 『--url/--comp-url 只接受 localhost』是否真在代码里 — seam-gate.mjs 有 localUrl(value, label) 校验函数,非 localhost 直接报错;--project 模式自己 spawn 预览服务后拼 http://localhost:<port> 再连。文档声明与实现一致。
  • [ok] seam-gate 到底验什么(本题重点) — 逐 seam 的报告行对应规则:ledger(plan 层 exit/entry 向量一致)、exit-moving / entry-moving(规则1/3:不许静止退出、不许从静止入场)、exit-direction / entry-direction(实测符号 = ledger 符号)、speed-match(law §3 速度匹配,仅 WARN)、zero-overlap(规则6:同帧只有一侧可见,切口不是叠化)、z-sign-scan(规则7:incoming 场景自身入场不得与 Z 符号打架)、carrier-*(规则3/4:carrier 矩形连续性,含祖先 scale,12px/5% 容差)。速度不匹配只是警告,不是失败——使用者需自己看警告与渲染帧对。
  • [ok] 子进程环境是否被显式过滤 — previewEnv() 只取 15 个白名单系统变量 + npm_config_audit/fund,不用 process.env 整包;另单独读 CHROME_PATH 找浏览器。
  • [ok] stamp 的写入边界 — seam-stamp.mjs 的 --write 目标 resolve 后必须落在当前项目目录内,且拒绝符号链接(lstatSync 判定)——降低借 ledger 写项目外文件的面。
  • [ok] 文档量化门禁是否都有出处 — 色值/字体/recipe 命名在 vox-collage-layout.md 与 SKILL.md 的 LOOK GATE;运动法则与反模式表在 motion-continuity.md;转场代码与占位符在 velocity-matched-transitions-gsap.md;ledger schema 与容差在 seam-gate.md。引用链完整。
  • [unlocatable] 『Grammar measured from Vox's Cooper Black film』所述测量过程与样本 — 该测量(以及 motion 的 frame-by-frame calibration)的过程与数据不在本 skill 目录内,无测量脚本或样本文件;只作为文档声明记录,本次只读侦查未运行 verifier 或渲染,故不作为已核事实使用。

6結論

  • 感覚から測定へ移行したシーム検証:ledger → stamp → gateの3点セットにより、ゼロオーバーラップ、方向、Z符号、キャリア連続性の自動検査が可能
  • スライド化を防ぐハード制約:ビートマップ段階でのモーション手法宣言を義務化し、「隣接ビートでの同一recipe・同一手法の禁止」「静止カード/左右分割は1/3以下」といった分布上限を設定
  • 美観の客観的ファクト化:実測値ベースのカラーパレット、タイトル用フォントにArchivo Blackを指定、黄色の丸を固定媒体とし、全フレームが命名済みrecipeに準拠
  • cut-don't-fake原則:ソース素材で実証できないビートは削って配分を再調整し、事前にビートマップの承認を得ることで、低コストな段階でリスクを遮断
  • 明確な出力境界:ユーザーのプロジェクトディレクトリのみに書き込み、自動公開は行わず、プライベート文書・認証情報・非公開URLの外部流出を防止、TTS APIは事前承認制
  • 最適な用途: 「日常のありふれた物の背後にある因果の歴史」を解説する60〜90秒の動画制作に最適です。ユーザーがトピックを指定する形式(topicモード)や、資料/リンクを提供する形式(sourceモード)のいずれにも対応し、Voxスタイルのコラージュ表現、ナレーション主導の構成、数値化された品質チェックを求められる場面に適しています。また、この手の動画制作を再現可能なパイプライン(ledger化されたシーム、再実行可能な検証ツール、引き継ぎ可能なビートマップ)に昇華させたい場合や、厳密なトーンや動きの連続性を重視するクリエイターにとって、シームツールチェーンが最大の価値を発揮します。
    不向きな用途: 不向きな用途:① ブランドテーマの適用が必要な製品発表動画(brand-faithfulワークフローの領分であり、本スキルはブランドトークンの無条件継承を明確に拒絶します);② 無人でのワンクリック自動生成(ビートマップ承認、デザインコンタクトシートの提出、キーフレームの目視確認が強制されます);③ 長編動画や複線的なストーリー構成(背骨のウェイト配分は60秒用に設計されており、一度に扱えるストーリーラインは1つのみです);④ 非公開素材がなく、recreation表記も受け入れられない題材;⑤ Chromeをインストールできない、またはローカルプレビュー環境を実行できない環境(数値シームゲートが機能しません);⑥ 完全オフライン動作を望み、npxによるパッケージ取得を拒否するユーザー環境。
    Install Agent-Ready
    ① Verified Mirror 2026-09-28
    Option A · Direct DownloadDownload vox-explainer.tar.gz
    sha256: e75b209b1949465d…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit ba7a0bb6d3.