Communitygithub.com

PR 動画作成 (PR to HyperFrames)

GitHub プルリクエスト (PRのURL、owner/repo#N、またはチェックアウトしたリポジトリの「このPR」) から、コード変更の解説動画を生成します。変更履歴、機能紹介、修正、リファクタリングのウォークスルーを、差分、コミット、ファイルから構築します。

PR 動画作成 (PR to HyperFrames) とは?

このスキルは、GitHub のプルリクエストを入力として、コード変更を解説するプロフェッショナルな動画を HyperFrames プラットフォーム上で生成します。開発者やテックリーダーが、複雑なコード変更をチームや関係者に説明する際に非常に役立ちます。入力はコード変更そのものであり、ウェブサイトのキャプチャは不要です。対応プラットフォームは HyperFrames で、Claude Code、Cursor、Codex などの AI エージェントから利用できます。ワークフローは0. セットアップ、1. PR情報の取り込み、2. デザインシステムの適用、3. ストーリーボードとスクリプト作成、4. ビジュアルデザイン、5. フレーム生成、6. 最終レンダリングの順に進行し、各ステップでゲートが設定されています。スキルは `npx hyperframes skills update pr-to-video` で常に最新の状態に保たれ、メディアアセットの利用には `/media-use` スキルを連携します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/pr-to-video

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

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

ドキュメント

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

最初に、このスキルを最新の状態に保ってください — ユーザーに確認してから実行: npx hyperframes skills update pr-to-video。すべてが最新の場合は高速なno-opです。そうでない場合は、このスキルとそれが依存するコアドメインスキルを、それらに依存する前に更新します。

media-use: オーディオ/画像/ロゴを調達する前に、/media-use を呼び出して、HeyGenカタログからのBGM/SFX/画像と、公式ソースからのブランドロゴを解決してください。最初に --adopt を実行して既存のアセットを登録します。/media-use スキルを参照してください。

PR to HyperFrames

このスキルを使用して、GitHub プルリクエストを取り込み、変更を理解し、コード変更解説動画を計画し、HyperFrames でフレームごとに構築します。入力は (gh 経由で読み取る) コード変更 であり、ウェブサイトではありません — キャプチャステップはなく、コントリビューターのアバター以外の実際のアセットもありません。

玄関口は /hyperframes です。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認してから続行してください。このスキルは GitHub プルリクエスト (コード変更) 用です。その他の意図、単なる「動画を作成」、または不確かな場合は、最初に /hyperframes を読んでください — インテントレイヤーがすべてのルート決定を所有し、BRIEF.md なしでここに到着した新しい作成は、とにかくそれを経由します (セットアップの開始ルール)。

あなたはオーケストレーターです。解決済みの外部 PROJECT_DIR で作業し、デフォルトでは呼び出し元のリポジトリでは作業しません。ステップを順番に実行し、各ゲートを通過してから続行してください。ユーザーゲートのあるステップは、ステップ0、ステップ3、ステップ6です。ステップ0の前に ../hyperframes/references/brief-contract.md を読んでください — ゲートタイプと、BRIEF.md の flow/storyboard がどのようにしてステップ3/4/6のゲートを支配するモードを導出するかが定義されています。ステップ5を除き、すべてのステップを自分で行ってください。ステップ5では、制限されたフレームワーカーのプールを派遣します。デザインやモーションのルールはここに配置しないでください。それらはフレームワーカーサブエージェント、このスキルのローカル ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/、および hyperframes-creative に存在します。

ワークフロー: ステップ0 セットアップ → hyperframes.json; ステップ1 取り込み → capture/extracted/ + assets/<login>.png; ステップ2 デザインシステム → frame.md; ステップ3 ストーリーボード/スクリプト → STORYBOARD.md と SCRIPT.md; ステップ3.1 オーディオ → audio_meta.json; ステップ4 ビジュアルデザイン → 拡張された STORYBOARD.md; ステップ5 フレーム → compositions/frames/NN-*.html と index.html; ステップ6 最終レンダリング → renders/video.mp4。


ステップ 0: セットアップ

目標: PR参照 (完全なURL、<owner>/<repo>#<N> 形式、またはチェックアウトされたリポジトリ内の「このPR」) を含む確認済みのブリーフを持って開始し、HyperFrames プロジェクトを作成し、ブリーフを永続化します。スタイルは常に code-editorial です (ステップ2で固定され、質問されることはありません)。

ブリーフはここでの質問ではなく、インテントレイヤーによって確認されます。 開始ルール、順番: (1) BRIEF.md が存在する → それを読み、何も質問しません — ブリーフは確定しており、その flow/storyboard がモードを導出します (ブリーフ契約 § 1)。(2) BRIEF.md はないが、プロジェクトが存在する (hyperframes.json / STORYBOARD.md がディスク上にある) → ストーリーボードのフロントマターと記録された設定から再開します。構築途中のプロジェクトに再質問することは決してありません。(3) どちらでもない — ここに直接到着した新しい作成リクエスト → /hyperframes を読み、そのインテントレイヤー (references/intent-interview.md) を実行します。レシピと記憶されたデフォルトをチェックし、このルートの質問を行います — PRサイズ→長さのドクトリンを含みます (これは ../hyperframes/references/routes/pr-to-video.md に完全に存在します) — その後、ロックされたブリーフを返します。編集リクエストはこれらすべてをスキップします — 編集を行ってください。

他の作業を行う前に、プロジェクトディレクトリを解決してください。ユーザーが指定したプロジェクトディレクトリを保持します。それ以外の場合は、リゾルバーによって出力される永続的な外部キャッシュロケーションを使用します。呼び出し元のリポジトリに videos/ を作成しないでください:

PR="<url | owner/repo#N>"
if [ -n "${EXPLICIT_PROJECT_DIR:-}" ]; then
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR" --project-dir "$EXPLICIT_PROJECT_DIR")"
else
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR")"
fi
echo "PR-to-video project: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs

機能のプレフライトは、フェッチ、ストーリー作業、オーディオ、またはフレームディスパッチの前に実行されます。インストールされたCLIがこのスキルに必要な検証コマンドを実行できない場合は、そのアップグレード手順を表示して停止し、実行のコンテキストを先に消費しないようにします。

$PROJECT_DIR/hyperframes.json が欠けている場合にのみ初期化します。そのベース名は PR から取得されます (例: acme-sdk-pr-1842)。ワークスペース名やタイムスタンプは決して使用しません。

npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video — init はインストールされたスキルを GitHub 上の最新のものと比較し、古い場合はグローバルセットを更新します。

以下のすべての相対パスコマンドは、$PROJECT_DIR を作業ディレクトリとして実行されます。明示的なサブシェルのない例は (cd "$PROJECT_DIR" && …) を意味します。呼び出し元のリポジトリのワーキングツリーを変更しないでください。

init の直後に BRIEF.md を書き込みます (init は空でないディレクトリを拒否するため、決して前には書き込みません): インテントレイヤーのロックされたブリーフ、../hyperframes/references/brief-format.md に従った形式。<MEDIA_DIR> をインストールされた /media-use スキルディレクトリとして解決します。次に、各設定に基づく回答を node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . で記録します (brief-format.md でサブセットが指定されています)。インテントレイヤーがレシピを採用した場合、node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> を実行します。これにより、その frame.md がプロジェクトにコピーされ (ステップ2はスキップされます)、ステップ3がドラフトするスケルトンが返されます。レシピは回答を埋めるものであり、承認ではありません。レビューゲートは依然として実行されます。

Setup を通過する前にサインインステータスを表示 — npx hyperframes auth status を実行し、その出力をそのまま中継します。音声/BGM が HeyGen を使用するか、ローカルエンジンを使用するかを報告し、サインアウトしている場合はサインイン方法を報告します。次の分岐を適用します:

  • 協調: ユーザーがサインインするか、明示的に offline / go を選択するのを待ちます。
  • 自律: ステータスを述べ、利用可能なローカルエンジンで続行します。

オフラインプロバイダーが存在しない場合に、必要な機能を黙って省略しないでください。ブロッカーを表面化させてください。この決定を別の質問に折りたたんだり、リポジトリごとの .env にキーを書き込んだりしないでください。認証の所有権とオフラインフォールバック: /media-use references/setup-providers.md § プロバイダー。

ゲート: hyperframes.json と BRIEF.md が存在する。PR参照がブリーフにキャプチャされている。設定に基づく回答が記録されている (ブリーフ契約 § 2)。サインインステータスが表示されている (サインイン済み、またはオフラインで続行)。


ステップ 1: PR の取り込み (キャプチャなし)

目標: PR の事実をフェッチし、情報源としてプロジェクトに組み込みます。ウェブサイトのキャプチャはありません。 fetch-pr.mjs は gh を決定論的に実行します — ページネーションされた gh api でファイルリストを完了させるため、大規模な PR でも ~100 ファイルで切り詰められることはなく、capture/pr.json + capture/diff.patch (スクラッチディレクトリなし) のみを書き込みます。MERGED PR の場合は、ベストエフォートで shipped_version (+ version_source) を pr.json に解決するため、エンドカードで実際のバージョンを引用でき、発明する必要がありません。次に ingest.mjs がそれをオフラインで合成キャプチャパッケージに組み込みます。

PR="<url | owner/repo#N | N>"

# PRを決定論的にフェッチ: ghを実行し、ページネーションされたgh apiでファイルリストを完了させる
# (大きなPRでも~100ファイルで切り詰められないようにする)、capture/pr.json +
# capture/diff.patchのみを書き込む — スクラッチディレクトリはなし。
# gh auth / not-found / private エラーはここでexit 1する。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)

# オフライン変換 → capture/extracted/{tokens.json (colors:[] → code-editorialパレット)、
# visible-text.txt (ブリーフ)、people.json (コントリビューター、ボットフィルター済み、
# name+login、avatarFile=assets/<login>.png)}。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
  --pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)

# 人物に関する唯一のネットワークステップ — 各コントリビューターのGitHubアバターを
# assets/<login>.png にダウンロード (クレジットクローズ用)。ベストエフォート。常にexit 0。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
  --people ./capture/extracted/people.json)

fetch-pr.mjs が exit 1 (gh auth / not found / private) した場合、その stderr を報告して停止します — PR の内容を作り出さないでください。ingest.mjs が exit 1 した場合、その stderr (通常は不正な pr.json) を読み、修正し、再実行します (決定論的)。fetch-people-avatars.mjs は常に exit 0 します。アバターがない場合は、作者へのクレジットクローズがないことを意味するだけです。

people.json は、gh が既に名前を付けているコントリビューター (PR作成者、コミット作成者、mergedBy) については name を持ちます。残り (レビュアー/コメンター/アサイニー、gh pr view はログインのみを返す) は null です。ステップ3でクレジットクローズを書く前に、そのフレームに実際に表示される1〜6人の人物について、null の名前を自分で解決します: gh api users/<login> --jq .name (既に gh があるので、これをスクリプト化する必要はありません)。GitHub にもそのユーザーの公開名がない場合は、画面上でログインにフォールバックし、その人を音声ラインから削除します (story-design.md のクレジットセクションを参照 — ナレーションは名前を言う必要があり、ハンドルをそのまま言ってはいけません)。

ゲート: capture/pr.json、capture/diff.patch、capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/people.json が存在する。PR の変更を明確な一文で述べることができる。assets/<login>.png はベストエフォート — その欠如は失敗ではありません。


ステップ 2: デザインシステム

目標: code-editorial フレームプリセットを採用します。スクリプトがこれをこの動画の frame.md + キャプションスキンに変換します。

スタイルは固定 — code-editorial (ウォームなエディトリアル。差分用に構築されたネイビーのコードサーフェス)。以下を実行:

node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .

スクリプトは code-editorial プリセットの FRAME.md を frame.md にコピーし、capture/extracted/tokens.json (PR にはない → colors:[]/fonts:[] は code-editorial 独自のパレット、完全なデザインを保持) のブランドトークンにリミックスし、プリセットのキャプションスキンを .hyperframes/caption-skin.html にコピーし、自己検証します (壊れたマッピングで exit 1)。exit 0 したらすぐに進みます — 手動編集は不要です。

ゲート: build-frame.mjs が exit 0 した — frame.md が code-editorial プリセットから存在し、.hyperframes/caption-skin.html がキャプションスキンソースとして存在する。


ステップ 3: ストーリーボードとスクリプト

目標: PR を承認されたフレームごとの説明計画に変換します。

../hyperframes-creative/references/story-spine.md (フック言語、証拠よりも価値、提案としてのストーリーボード、ソーストレーサブルなビジュアル)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md、../hyperframes/references/script-format.md を読みます。それらを使用して STORYBOARD.md と、ナレーションが必要な場合は SCRIPT.md を書きます。フロントマターの duration: をブリーフの length から設定します — これは大まかな期待値であり、アセンブリは実際のカットがどこに着地するかを報告します。

PR のアーキタイプ (changelog / feature-reveal / fix-explainer / refactor-walkthrough)、PR ネイティブのフレームタイプ、フック、説得、ビート、フレームごとの単語予算、クレジットクローズには story-design.md を使用します。シーケンスは ナラティブデザインから来ており、diff のファイル順ではありません — 変更を説明し、diff を音読しないでください。ソフトガイドとして、../hyperframes-animation/blueprints-index.md のロール→ブループリントメニューを参照します。各ビートについて、候補ブループリントが暗示する形状でナレーションを書き、1つ適合する場合はその候補 blueprint: id をタグ付けします (ストーリーの真実がどのビートが存在するかを決定します — 形状に合わせてビートを強制しないでください)。capture/diff.patch から実際の diff ハンクを2〜4つフィーチャーし、それぞれを小さな読みやすいスニペットにします。各フレームの scene で必要な code-* ブロックに名前を付けます。フレームは、credits クローズ (1〜6 個の assets/<login>.png アバター) を除いて asset_candidates を持ちません。ストーリーボードとスクリプトのリファレンスから正確な必須フィールドを使用します。

ドラフト後、レビューループの計画パスを実行します — ../hyperframes/references/review-loop.md § 1: 計画を提案として提示し、2つの質問をします — 承認するか変更するか、そしてスケッチを先に (推奨) またはスキップするか。フィードバックはチャット返信として届きます。承認されるまでループします。これは チェックポイントゲート です (ブリーフ契約 § 1): 自律モードでは質問することは何もありません — 同じサマリーをヘッズアップとして投稿し、続行します。スケッチはビルドに統合され、1つの質問付きの最終プレビューはステップ6で行われます。

ゲート: STORYBOARD.md が存在し、すべてのフレームが必要なナラティブフィールドを持っている。ナレーションが必要な場合は SCRIPT.md が存在する。ユーザーが計画を承認した (自律モード: サマリーがヘッズアップとして投稿された)。


ステップ 3.1: オーディオ

目標: 承認されたスクリプトから、ナレーション、単語タイミング、音楽、オーディオメタデータを生成します。

ステップ3の承認後にオーディオを開始します。バックグラウンドで実行し、その後ステップ4に進みます。

呼び出す前に、ユーザーの要求からナレーションボイスを選択します。 リクエストが声、性別、トーンを指定した場合は、一致する音声IDを選び、--voice <id> で渡します。パイプラインのデフォルトは、HeyGen では Marcia (女性)、Kokoro では am_michael です。そのため、「男性の声」のようなリクエストは、フラグを渡さない限り黙って無視されます。音声IDはプロバイダー固有です。ステップ0のサインインステータスで選択されたプロバイダーに基づいて解決します: HeyGen (サインイン済み) の場合は node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (または GET /v3/voices?engine=starfish); Kokoro (オフライン) の場合は <MEDIA_DIR>/audio/references/tts.md の音声テーブル (am_/bm_ 接頭辞が男性、af_/bf_ 接頭辞が女性) を使用します。ユーザーが好みを表明しなかった場合は、パイプラインのデフォルトにフォールバックする前に、記憶された音声にフォールバックします (ブリーフ契約 § 2)。

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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`.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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`.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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`.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

関連スキル