pr-to-video

プルリクエストの変更を、動画で紹介したいときに効きます。リリースの告知、新機能のお披露目、修正の解説、作り替えの説明などです。

入力はコードの変更

入力は Web サイトではなくコードの変更で、gh で差分・コミット・ファイルを読みます。

HyperFrames の作り方の 1 つで、入口の hyperframes から振り分けられて使う作りです。

段の流れ

3 段目の承認は、自律の進め方では要約を知らせるだけで先へ進みます。描き出しの前の「いま書き出すか、何を変えるか」だけは、自律でも必ず聞く決まりです。

製品の宣伝や、PR の無い話題の解説

製品の宣伝や、PR の無い話題の解説。説明文が、それぞれ別の作り方（product-launch-video、faceless-explainer）に回すよう書いています。

PR が読めないとき

PR が読めないとき。取得に失敗したら止まり、PR の中身をでっち上げない決まりです。

解析で見つかったこと

SKILL.md の解析では、シェルコマンドの実行とパッケージの導入の記述が見つかっています。実行できるスクリプトが 27 件（JavaScript）同梱されています（2026-10-17 確認）。

同梱ファイルは 34 件で、筋の設計、見た目、動き、コードの見せ方の資料です（2026-10-17 確認）。

非公開のリポジトリの動画

貢献者の名前とアイコンが入る

貢献者の名前とアイコンが動画に入ります。締めの場面で、PR の作成者やレビュアーなどのアイコン画像と名前を出します。社外に出す動画なら、載せてよいかを本人に確かめるのが無難です。

作業のフォルダはリポジトリの外

作業のフォルダは、今のリポジトリの外です。手元のリポジトリの中に videos/ を作らず、外の置き場を使う決まりです。

声は指定しないと既定の声

声は指定しないと既定の声になります。依頼文で声や性別を指定しないと、既定の声になる、と注意されています。HeyGen では女性の声（Marcia）、手元の Kokoro では男性の声（am_michael）が既定です。日本語の語りにしたいときも、依頼文で明示してください。

最初に更新の命令を勧める

最初に更新の命令を勧めます。冒頭で npx hyperframes skills update pr-to-video を、利用者に確かめてから実行せよ、としています。

インストール数と全体の関係

インストール数は約 19.4 万件です。同じリポジトリの 26 件は約 5.6 万〜49.7 万件に散っていて（2026-09-07 の上流集計）、入口から入る作りです。

全体の関係は hyperframes の地図にまとめています。

大きな PR でも読めますか

読めます。ファイルの一覧を GitHub の API で最後までたどるので、100 ファイルほどで途切れない、と書かれています。ただ、動画に入る場面の数は限られるので、見せる変更は台本の段で絞ることになります。

見た目は変えられますか

本文では固定です。見た目は「コード向けの編集調」（紺色のコードの面）に決めてあり、「聞かない」と書かれています。

音の無い動画にできますか

できます。台本（SCRIPT.md）を作らず、計画に music: none と書き、効果音の指定（sfx:）も置かないと、語りも BGM も効果音も作らない決まりです。

字幕は付きますか

語りがあれば、言葉ごとの時刻から字幕を作ります。字幕だけを別の動画に付けるなら embedded-captions です。