Communitygithub.com

SingleGrain-Team/video-skills

画面収録を大きなフレームで再生し、チェックリストの各項目が収録内の該当ステップ発生時にチェックされ、最終的に全項目がチェックされて短いホールドで終了するモーショングラフィックを構築します。製品ウォークスルー、チュートリアル、オンボーディング、インストールデモなどの画面収録と、タイムスタンプ付きのステップリストがある場合に、「ステップが実行される様子を見る」動画を作成します。入力は収録、ステップラベルとタイムスタンプ、タイトル、オプションのパレットです。出力は1920x1080のH.264 MP4と編集可能なHyperFramesプロジェクトです。

video-skills とは?

このスキルは、画面収録とタイムスタンプ付きのチェックリストを組み合わせたモーショングラフィック動画を生成します。左側に画面収録を表示し、右側にチェックリストを配置。収録内の各ステップの発生時刻に合わせて、対応するチェックリスト項目が自動的にチェックされます。最終的に全項目がチェックされた状態で短時間ホールドされ、視聴者に完了感を与えます。 主なユースケースは、製品ウォークスルー、チュートリアル、オンボーディング、インストールデモなど、手順を追って説明する動画です。入力として、画面収録動画(16:9推奨)、3〜7個のステップラベルとそのタイムスタンプ、タイトル、オプションのカラーパレットを受け取ります。出力は1920x1080、H.264形式のMP4ファイルと、編集可能なHyperFramesプロジェクトファイルです。 このスキルは、HyperFramesフレームワーク上で動作し、`create.mjs`スクリプトがspec.jsonと収録動画からプロジェクトを自動生成します。タイミングルールは厳密で、チェックは指定された時刻に正確に表示され、ステップ間の間隔は1.5秒以上必要です。また、タイムスタンプが提供されない場合は、ffmpegでフレームを抽出して分析し、各ステップが視覚的に完了または進行中である最初のフレームを自動的に特定します。 検証プロセスでは、レンダリングされた動画のフレームを抽出し、チェックのタイミングや表示が正しいか、収録画面のテキストが判読可能か、ラベルがクリップされていないかを確認します。ffprobeによるフォーマット確認も行います。最終的に、動画ファイルとプロジェクトディレクトリが納品物となります。

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

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

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

ドキュメント

チェックリストオーバーレイ

左側に画面収録、右側にチェックリスト。各項目は、そのステップが画面上で発生した瞬間にチェックされます。最後のチェックが行われると、動画は完全にチェックされたリストの状態でホールドされます。

入力

入力備考
収録1つのローカル動画ファイル。理想的には16:9。無音でも問題ありません。
ステップ3〜7個の項目:{ "label": "...", "at": <収録開始からの秒数> }。ラベルは短い命令形のフレーズ(約2〜4語)にします。
タイトル1行。結果を示します(例:「5ステップでエージェントにスキルを追加する」)。
サブタイトルオプションの1行。
パレットオプションの16進数オーバーライド:bg, surface, panel, ink, muted, accent, border, accentInk。デフォルトはオレンジのアクセントカラーを使ったダークテーマ。accentInkはaccent上で読みやすい十分な濃さにしてください。

タイムスタンプが提供されない場合は、収録をスクラブし(ffmpegで1〜2秒ごとにフレームを抽出して確認)、各ステップが視覚的に完了または進行中である最初のフレームを選択してください。推測しないでください。

ワークフロー

  1. プロジェクト契約のために/hyperframes、/hyperframes-core、/hyperframes-cliを読み込みます。
  2. spec.jsonを記述します:
    { "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" },
      "steps": [ { "label": "アプリを開く", "at": 1.5 }, { "label": "検索", "at": 7.9 } ] }
    
  3. プロジェクトディレクトリにコンポジションを生成します: node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2] これにより収録がコピーされ、最後のフレームが抽出され(収録終了後も画像がホールドされるように)、収録に合わせたサイズのindex.htmlが書き込まれます。全長 = 収録時間 + ホールド時間(デフォルト2.2秒)。
  4. npx --yes hyperframes checkがエラー0、警告0でパスする必要があります。
  5. 検証(後述)を行い、その後レンダリング:npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4。

タイミングルール

  • チェックはステップ上に正確に表示され、決して前には表示されません。塗りつぶしとチェックマークの描画はt = atで開始され、描画は約0.3秒後に完了します。atより前に項目がチェックされたように見えてはいけません。
  • タイムスタンプは収録時間であり、収録はコンポジション時間0から始まるため、atはそのまま使用されます。収録をトリミングする場合は、すべてのatを同じ量だけシフトしてください。
  • 「次はこれ」というアウトラインが、前のチェックの直後に次の項目に表示される場合があります。これはアウトラインのみであり、塗りつぶしやチェックマークは含まれません。
  • 各チェックが認識できるよう、チェック間は少なくとも1.5秒以上間隔を空けてください。2つのステップが近すぎる場合は、それらをマージしてください。
  • 最後のチェックは収録終了の少なくとも1.5秒前に行われるか、完了したリストが2秒以上表示されるように--holdを増やしてください。
  • カウンター(n / N)、プログレスバー、フレームリングのパルスはすべて同じatの値に連動するため、同期が保たれます。

レイアウト(16:9収録の場合)

1920x1080のキャンバス、56ピクセルのマージン。タイトルとサブタイトルは上部に配置。収録フレームはヒーローとして約1250ピクセル幅(幅の約65%)、チェックリストパネルはその右側に520ピクセルのカラムとして配置し、フレームと同じ高さにします。項目は高さを均等に分割します。これにより、収録内のUIテキストが読みやすくなります。フレーム幅を約1100ピクセル以下に縮小しないでください。縦長の収録の場合、ジェネレーターはアスペクト比に応じてフレームをスケーリングします。16:9以外の収録の場合:フレームがヘッダーの下に収まるか確認するか、最初に収録をクロップしてください。

ラベルは32ピクセルで2行に折り返されます。約26文字以内に収めてください。

検証

レンダリングされたfinal.mp4に対して、スナップショットだけでなく、以下の手順を実行します。

  1. 各ステップについて、atの0.08秒前のフレームと0.45秒後のフレームを1つずつ抽出します:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png。
  2. それらを確認します。前:項目は未チェック、カウンターはi-1。後:項目は塗りつぶされチェックマークあり、カウンターはi、プログレスバーが進んでいます。
  3. 最後のホールド部分のフレーム(終了の約0.2秒前)を抽出します:すべての項目がチェックされ、カウンターはN / N、バーは満タン。
  4. 収録内のテキストがフレーム内で判読可能で、ラベルがクリップされていないことを確認します。そうでない場合は、spec.jsonまたはパレットを修正して再生成します。
  5. ffprobeでファイルを確認:1920x1080、h264、duration = 収録時間 + ホールド時間。

納品

final.mp4へのパス、その長さ、使用されたステップのタイムスタンプを報告します。プロジェクトディレクトリ(index.html、assets/、spec.json)は、異なるラベルやパレットで動画を再生成できるよう保持します。ユーザーがStudioで編集したい場合は、先にnpx hyperframes previewを開いてください。

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

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

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.

関連スキル