Communitygithub.com

SingleGrain-Team/video-skills

コード変更(プルリクエスト、リリース、未コミットの差分)を、差分を読まない人向けに約30秒の動画で説明します。

video-skills とは?

このスキルは、開発者がプルリクエスト(PR)やリリース、ローカルの未コミット差分を、非エンジニアや忙しいチームメンバーに伝えるための約30秒の動画を自動生成します。HyperFramesというツールを使用して、動画は5つのセクションで構成され、最初に差分が高速スクロールで読めないことを示し、その後平易な言葉での要約、4つの具体的な機能説明(コードスニペット付き)、最後にインストールコマンドとURLで締めくくります。このスキルは、PRのレビューやリリースノートを、従来のテキストベースのコミュニケーションでは伝わりにくい関係者向けに、視覚的にインパクトのある説明動画に変換するのに役立ちます。出力は1920x1080のH.264 MP4ファイルと、編集可能なHyperFramesプロジェクトフォルダ一式です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/pr-explainer-film

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

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

ドキュメント

pr-explainer-film

デフォルトでは無音の、5つのパートからなる約30秒の動画。その構成こそが重要です。視聴者は「差分は読めない」と感じた後、平易な言葉で答えを得て、証拠を見て、何を入力すべきかを知ります。

時間パート目的
0-2秒フック変更の規模を伝える("15ファイルが変更されました")
2-8秒差分ブラー実際の差分が高速スクロール;カウンターが増加
8-13秒平易な言葉1文のヘッドラインと3つの短いポイント
13-23秒4つのビート各機能を1つずつ、実際のコード行と共に表示
23-30秒クロージングインストールコマンドがタイプされ、続けてURLを表示

入力

構築を始める前にこれらを収集します。不足しているものだけを尋ねてください。

  1. 変更ソース: GitHubのPRまたはリリース(gh pr diff, gh pr view --json title,body,files)、またはローカルのワーキングツリー(git diff と追跡されていないファイル)。読み取り専用です。リポジトリを変更しないでください。
  2. オーディエンス: 差分を読まない人(顧客、チームメイト、フォロワー)。これによって要約やビートの語彙が決まります。
  3. CTA: 正確なインストールコマンドとURL。そのまま使用します。製品に標準的なコマンドが一つある場合は、そのコマンドのみを表示し、他のツール名は表示しません。
  4. ブランド: パレット、ロゴ(自身のファイル)、フォント。テンプレートのデフォルトはニュートラルでダークです。

ワークフロー

  1. 変更を読む。 追加/削除数と実際の差分ハンクを含むファイルリストを取得します。非エンジニアが理解できる一文で変更を記述します。それができないなら、まだ変更を理解していない証拠です。
  2. コンテンツを選ぶ(references/content-rules.md を参照):フック番号、ブラー用の5〜8個の差分ハンク、3つの要約ポイント、正確に4つの機能ビート、CTA。
  3. スキャフォールド。 npx --yes hyperframes init <dir> --non-interactive --example=blank を実行し、生成されたファイルを template/index.html と template/film.config.js で上書きします。ロゴがあれば assets/logo.png に配置します。
  4. film.config.js を記述する。 すべての文言、スニペット、数値はここに記述します。index.html は、:root 内のブランド変数、タイミング、またはレイアウトを変更する場合にのみ編集します。
  5. 検証する: npx --yes hyperframes lint を実行し、次に npx --yes hyperframes check を実行します。すべてのエラーを修正します。既知の許容可能な警告:nested_structure_needs_subcomposition(ブランド変更を容易にするため、意図的にファイルを1つにしています)。
  6. 確認する。 npx --yes hyperframes snapshot --at 1,4,6,8.3,11,14,17,19.5,22,26,29 を実行し、snapshots/contact-sheet-*.jpg を開きます。以下のリストと照合し、問題がなくなるまで修正と再スナップショットを繰り返します。
  7. レンダリングする。 npx --yes hyperframes render --quality high --workers 2 --output final.mp4 を実行します。ffprobe で1920x1080、H.264、28〜34秒であることを確認します。
  8. 再度確認する MP4から抽出した4〜6フレーム(ffmpeg -ss T -i final.mp4 -frames:v 1 f.png)を確認します(スナップショットだけではありません)。

フォーマットを機能させるためのルール

  • 差分は実際のものでなければならない。 実際の差分から実際のコード行をコピーします。コードやカウントをでっち上げないでください。git diff --shortstat と新しいファイルの wc -l からカウントを計算します。
  • 意図的に読めなくする。 スクロールは加速(power2.in)し、ぼかしがかかります。人が読めるように速度を落とさないでください。「読むには多すぎる」というカードがその代償を支払います。
  • 言葉の後に証拠。 要約はどの機能ビートよりも先に表示されます。各ビートのタイトルは2〜4語のメリットです。説明は1文で専門用語はありません。スニペットは1〜5行の実際のコードで、主要な行が強調表示されています。
  • 正確に4つのビート、各ビートは1つのアイデア、それぞれ約2.6秒です。テキストを縮小するよりも、弱いビートを削除します。
  • 画面の切り替え。 差分とビートはダーク、要約は一つのライトシーン。背景の変化は「今はシンプルです」という合図です。
  • コマンドで締めくくる。 実際のコマンドを一文字ずつタイプし、続けてURLを表示します。第2のCTAはありません。
  • コピーの衛生。 競合他社や無関係なツールに言及しているコードコメントは、スニペットに到達する前に削除します。CTA以外のCLIは絶対に表示しないでください。
  • アセットは自身のものを。 自身のロゴ、マシンに既にあるフォントを使用し、ストックやサードパーティのメディアは使用しないでください。音楽はオプションです。使用する場合は、商用利用が許可されているトラックのみを使用し(media-use で解決)、動画は無音でも完全に読み取れるようにしてください。
  • 決定性。 コンポジション内で Math.random、Date.now、ネットワークコールを使用しないでください。アニメーションテキストとカウンターはトゥイーンの進行値から駆動し、シークが正確になるようにします。

フレームチェックリスト(ステップ6と8)

  • フック番号と文言が実際の変更と一致している。
  • 差分ウィンドウがそのフレーム内に収まっている。ファイルヘッダーと緑/赤の行が静止時は判読可能で、移動時はぼやけている。
  • カウンターが真の数値で終了している。
  • 要約スライドがフェードアウトする前に3つのポイントすべてを表示している。
  • すべてのビートにタイトル、文、スニペットが一緒に表示され、何も切れていない。
  • 最終フレームに完全なコマンドとURLが正確に表示されている。

成果物

final.mp4 とプロジェクトフォルダ(index.html、film.config.js、assets/、meta.json)を引き渡します。パス、再生時間、許容された検証警告を報告します。フォルダは同じコマンドで再レンダリングできます。次のリリースのためにブランド変更や再利用をするには、film.config.js のみを編集します。

サイズと文言の制限については references/content-rules.md を参照してください。

Individual skills in this repo

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

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a motion graphic where a screen recording plays in a large frame beside a checklist, and each checklist item ticks off at the exact moment that step happens in the recording, ending with every item checked and a short hold. Use when someone has a screen recording (product walkthrough, tutorial, onboarding, install demo) plus a list of steps with timestamps and wants a "watch the steps get done" film. Input is a recording, step labels with timestamps, a title and an optional palette; output is a 1920x1080 H.264 MP4 and the editable HyperFrames project.

SingleGrain-Team/video-skills

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an editable HyperFrames project.

SingleGrain-Team/video-skills

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

関連スキル