Communitygithub.com

josueh04/product-video-skills

HyperFramesを使用したナレーション付き製品デモを構成します。ステージ(実際のビューポートで再構築され1080pにスケーリングされた製品UI、カメラ、ベールによるラックフォーカス、チャプタータイトル、カーソルとクリック、タイピング、ストリーミングテキスト、ポップアップ、トースト、スクロール、エンドスクリーンとロックアップ)と、ナレーションの各単語にすべてのビートを固定するbuild.pyを扱います。ビデオのvideo/build.py、src/template.tpl、src/app.cssを作成または編集するとき、単語にビートを配置するとき、チャプター、クリック、ポップアップ、プッシュインを追加するとき、画面をフレーミングするとき、エンドスクリーンやロックアップを構築するとき、セットアップビートのスナップショットを撮るとき、またはこのワークベンチで製品ビデオのドラフトまたは納品用MP4をレンダリングするときに使用します。また、「カーソルがずれている」「ズームしすぎ」「速すぎ」「混乱している」「タイトルがちらつく」「UIを音声に同期して」と言われたとき、またはUIのウォークスルー、デモ、ピッチビデオが求められたときにも使用します。

product-video-skills とは?

このスキルは、HyperFramesフレームワークを使用して、ナレーション付きの製品デモ動画を構成するためのものです。製品のUIを実際のビューポートで再構築し、1080pにスケーリングした上で、カーソル、クリック、タイピング、ストリーミングテキスト、ポップアップ、トースト、スクロール、エンドスクリーンなどの要素を視覚的に同期させます。特に、すべてのビート(アクションのタイミング)をナレーションの特定の単語にアンカーすることで、音声とUIの動きを完全に一致させる点が特徴です。Claude Codeエージェント向けに設計されており、build.pyというPythonスクリプトでタイミングテーブルを定義し、テンプレートとCSSでUIを再構築します。このスキルは、ウォークスルー、デモ、ピッチビデオの制作を効率化し、レビューでよく指摘される「ズームのしすぎ」「動きが速すぎる」「カーソルが合っていない」といった問題を回避するための具体的なルールとフレーミングガイドラインを提供します。また、署名ゲートによって、ビデオの内容とクレームが事前に合意されていることを確認してからビルドを実行する仕組みも備えています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/josueh04/product-video-skills/tree/HEAD/skills/ui-demo-composer

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

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

ドキュメント

UIデモコンポーザー

ここでの製品ビデオは、ビデオごとに作成する3つのファイルと、すべてのビデオで共有されるキットから構成される1つのHyperFramesコンポジションです。

ファイル説明編集者
video/build.pyビートテーブル T:すべてのタイミングは単語のタイミングから導出されるあなた
video/src/template.tpl再構築されたUI、スクリーンレイヤー、GSAPタイムラインあなた
video/src/app.css製品UIのCSS、specs/からのリテラル値あなた
kit/stage.css, kit/titles.css, kit/stage.jsステージレイヤーとシークセーフなヘルパーこのスキル
products/<slug>/kit/tokens.css, fonts/, icons/, ui/製品のトークン、フォント、アイコン、共有UIパーツproduct-kit
video/index.htmlbuild.pyによって生成される。手動で編集しない誰もしない

scripts/buildlib.py はすべてのビルドに共通の部分(タイミング、署名ゲート、オーディオタグ、インライン化、プレースホルダー、アイコン、カメラクランプ)を処理するため、build.pyはビートの短いリストに留まります。

ステージモデル

#root > #stage > #camera > #blurWrap > #app      製品、アプリピクセル単位
               > #veil, .pvs-ttl, #endS, #lock, #fade      スクリーンスペース、1920x1080
  • UIは実際のビューポートで再構築され、一度だけスケーリングされます。 #app は product.yaml app_canvas.logical CSSピクセル(例:1440x810)で、1つのtransformによって1920x1080にスケーリングされます。 プロダクションCSSはリテラルなピクセル値を保持するため、スペックの値は変更せずに貼り付けられ、すべての測定値はコードと1:1で比較できます。 アプリのブレークポイントより上のデスクトップ幅を16:9で選択します。画面録画がある場合は、その論理サイズを使用します。 16:9でないキャンバスはレターボックス表示されます(buildlibが警告します)。
  • 位置は測定され、入力されることはありません。 S.box(sel) はフォント読み込み後に #app までのオフセットを合計します。CSSが変更されても、カーソルはボタン上に留まります。
  • カーソルとクリックリップルは #app の最後の子要素であるため、製品と一緒にスケーリングおよびブラーされます。ポップアップ(.pvs-modal)とトースト(.pvs-toast-slot)も #app 内に配置されます。
  • #camera のみが移動し、#blurWrap のみがブラーを適用します。 #app や #stage をトゥイーンしないでください。

フレーミング:デフォルトは1倍の全ページ

すべての製品ビートはデフォルトで1倍、全ページとし、ポップアップは自然なサイズで、アプリが表示するように中央揃えにします。プッシュインは控えめに(最大 video.max_zoom、デフォルトは1.35まで)、セクション全体をフレーム内に収め、ラベルの端がフレームの端に掛からないようにします。チャプターごとに1つのフレーミング:製品がフォーカスアウトしている間にチャプタータイトルの後ろで移動を行うか、1つのゆっくりとした特徴的な動きとして行います。

理由:このスキルの元となったプロダクションでは、設定動画がズームのために2回却下されました。1.67倍の押し込みはラベルを半分に切りました(「何が起こっているかわからない」)。その後、列ごとに約2倍のフレーミングは、何も切っていなくても窮屈に感じられました。レビュアーが見本として挙げた動画は、常に1倍で動作していました。遠くに表示されたキャンバス(50%で表示)や狭いチャット列はより多くのズームに耐えられます。product.yamlでその製品の max_zoom を上げてください。ビートごとではありません。b.cam() と S.cam() は max_zoom を超えるとクランプし、警告を出します。詳細と数値:references/framing-and-pacing.md。

ペーシング:チャプターは間(ポーズ)

  • UIの途中ではなく、コンテキストから始めます:ロゴ、製品名、製品が何であるかを1行で、製品をフォーカスアウトした状態で表示します。
  • 各チャプターは、製品をラックフォーカスアウト(ブラーとベール)した状態で2トーンのタイトルから始まり、約1.4秒以上保持し、フォーカスは最初のアクションを指定する単語の直前に戻ります。画面の変更はタイトルの背後で行われるため、ハードカットはありません。
  • チャプターごとに1つのアイデア、一度に1つの変更、0.6〜1秒間隔、各チャプターの最後に約0.8秒のホールド。製品の実際の待機時間は1〜2秒に圧縮します。
  • エンドスクリーンは幅広さ(製品が他に何ができるか、実際のUIパーツを使用)を示し、その後ロックアップを表示します。

理由:0.5秒ごとにマイクロアクションがある密度の高いワンテイクカットは、作成者には洗練されていると読まれ、レビュアーにはノイズと読まれました(「速すぎる、一度に多すぎる、圧倒される」)。結果のズームイン・アウトはフォローするのを不可能にしました。落ち着いたチャプター分割バージョンが承認されました。

すべてのビートは単語にアンカーされる

b = buildlib.Build(__file__)
T, w, end = b.T, b.w, b.end
T["N2"] = T["ch1"] + 0.3                                  # クリップIDを配置するとそのクリップが配置される
T["rack1"] = T["N2"] + w("N2", "after") - 0.25            # "after"の直前にフォーカスが戻る
T["send1"] = max(T["type1"] + T["type1Dur"] + 0.4, end("N3") + 0.15)
  • w(clip, prefix, nth=1) は、クリップを基準として、prefix で始まる最初の単語の開始位置です。単語が見つからない場合はエラーを発生させます(黙ったフォールバックなし:フォールバックが静かにデフォルトのタイミングにビートを配置すると、モーションが気付かれないうちに音声からずれていきます)。
  • UIイベントは、それを指定する単語より0.05〜0.45秒先行します。max() はナレーションの順序と「UIが完了した」ことの両方を保証します。end(k) は T[k] にクリップの継続時間を加えたものです(または b.dur(k, d))。
  • タイピング速度は1秒あたりの文字数(約17〜21)、またはビートに合わせて固定されます。
  • クリック、タイピング、ポップはそれぞれ同じ T でサウンドを取得します(b.click(t)、b.typing(text, t, dur)、b.pop(t))。そのため、タイミングを変更したビートはそのサウンドも一緒に移動します。
  • 音声の1行を再生成すると、ビデオ全体のタイミングが再計算されます。それがポイントです。

理由:タイミングには単一の真実のソースがあります。行が再生成されると、それにアンカーされたすべてが一緒に移動します。手動で入力した秒数は、最初のリテイクで古くなります。

ワークフロー

  1. BRIEF.md(チャプター、フレーミング)、COVERAGE.md(各チャプターが画面上で説明しなければならないこと)、specs/*.md、TRUTH.md を読みます。UIを発明しないでください:SOURCES.md または specs/ にソースがない画面や動作は含めません。
  2. スペックから src/template.tpl と src/app.css で画面を再構築し、product.yaml cast からの架空のデータを使用します。別のビデオからコピーする代わりに、kit/ui/ から {{UI:name}} を使用して製品パーツを再利用します(references/ui-component-library.md)。
  3. build.py にビートを記述し、テンプレート内のタイムラインをキットヘルパーを使用して記述します(APIについては references/stage-kit.md、各ビートについては references/beat-recipes.md、エンドスクリーンとロックアップについては references/end-screen-and-lockup.md)。すべてのトゥイーンに対してシークセーフモーションのスキルに従います。
  4. ドラフトをビルドし、出力されるビートテーブルを読みます:
    PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
    "$PVS_HOME/bin/pvs-py" <video_dir>/video/build.py --draft
    
    音声が存在する前でも、--draft --fake-timings は lines.tsv から単語のタイミングを生成するため、画面をレイアウトできます。
  5. lintとチェックを実行します。<video_dir>/video/ から:
    "$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/seek-safe-motion/scripts/lint_motion.py" .
    npx --yes [email protected] check
    
    エラー0、ランタイム警告0を期待します。モノリシックなステージに対しては1つのlint警告が予想されます:composition_file_too_large(キットがインライン化されています)。次に、ビルドが出力する2番目の check を実行します。check --at <setup beat times>:デフォルトのサンプルはラックされた瞬間にのみ配置されることが多く、キットはコントラストパスから製品テキストを隠します(意図的にブラーがかけられています)。そのため、contrast ... checked 0 はビューアが読むものを何も監査しませんでした。check だけでは不十分です。移動するアイテムがその経路の大部分で見えなかったビデオで合格しました。フレームを確認してください。
  6. すべてのセットアップビートのスナップショットを撮り、各画像を自分で確認します。build.py で b.snap(t, label) を使用してマークします。ビルドは正確なコマンドを出力します:
    npx --yes [email protected] snapshot . --at 3.2,4.7,9.98 --no-end --describe false -o snapshots/setup
    
    --no-end はそれらの時刻のみをキャプチャします。--describe false はフレームが外部のビジョンAPIに送信されるのを防ぎます。フレーミング(端で何も切れていないか)、ターゲット上のカーソル、自然なサイズで中央揃えされたポップアップ、タイトル全体を確認します。--zoom "#toast" --zoom-scale 2 は1つの要素を切り抜きます。疑わしいトゥイーンをテストするには、--at <start>,<later> は --at <later> と一致する必要があります。
  7. レンダリングします。レビュー用のドラフト、その後 BRIEF.md が署名されたら納品用(build.py がこの行を出力します):
    npx --yes [email protected] render . -o renders/<video>-v<k>.mp4 --fps 30 --quality draft
    npx --yes [email protected] render . -o renders/<video>-v<k>.mp4 --fps 30 --quality delivery
    
    その後、MP4に対してrender-qaを実行します。すべてのバージョンのMP4を保持します。

署名ゲート

build.py は、coverage_signed_by と claims_signed_by が BRIEF.md に設定されるまでビルドを拒否します(終了コード2)。--draft はとにかくビルドし、<meta name="pvs-draft" content="1"> を index.html にスタンプします。QAはレポートをドラフトとしてマークし、納品はそれを拒否します。レビュアーに代わって署名しないでください。また、メタを削除しないでください:ドラフトは確認用であり、出荷用ではありません。

理由:このスキルの元となったプロダクションでは、26バージョンのうち9つが、ビデオがレビュアーの気になる機能を説明しておらず、ビルド前にそれらの機能を誰も書き留めていなかったために発生しました。ゲートは合意が最初に来るようにします。

インシデントから来たルール

  • プロダクションのグリッチを修正し、見た目は維持します。 レイアウト、トークン、動作は1:1に保ちますが、ライブアプリの目に見える欠陥(パディングの欠落、あふれている、または切れているテキスト、グレーのネイティブコントロール、クリック後に残ったフォーカスリング)を修正します。すべての修正を BRIEF.md のノートにリストします。
  • 製品が設定可能な場合は、設定可能なものを表示します。 購入者が尋ねるであろう設定は、ナレーションだけでなく画面上に表示する必要があります。
  • メニューを閉じてから、その上にモーダルを開くまで1フレーム空けます。 新しいダイアログの下にある開いたドロップダウンは、1つのレンダリングでゴーストテキストを残しました。
  • エンドスクリーンのコンテンツのみをロックアップにフェードインし、 ロックアップが表示されるまでその背景を保持します。両方をフェードすると、それらの間にシャープなUIのフレームが表示されました(S.lockup はこれを行います)。
  • クリックの前にホバーします(hov クラスを約0.12秒前に)、カーソルは最初のラック後にインし、エンドスクリーンの前にアウトします。
  • UI、データ、ナレーションに ベンダー名や禁止用語 を含めません(product.yaml banned_terms、names)。実際の画面に表示される場合は、その部分をフレームの外に保ち、決して視覚的に空のままにしないでください。
  • 進行状況を早く示すためにレンダリングしないでください。 スナップショットで反復します。セットアップビートが正しく見えたらレンダリングします。

ファイル

パスいつ読むか
references/stage-kit.mdヘルパーのシグネチャ、プレースホルダー、CSS変数、またはbuildlib APIが必要なとき
references/beat-recipes.md特定のビート(オープニング、チャプター、クリック、タイピング、ストリーミング、ポップアップ、ドロップダウン、トースト、スクロール、プッシュイン)を構築するとき
references/framing-and-pacing.mdフレーミングやリズムを選択するとき、またはレビュアーが「ズーム」「速い」「混沌」と言ったとき
references/end-screen-and-lockup.mdエンディングを構築するとき
references/ui-component-library.mdUIパーツが複数のビデオに表示される場合、または別のビデオからマークアップをコピーしようとしているとき
scripts/buildlib.pyAPIリファレンスがカバーしていない動作が必要なとき
kit/stage.js同上、タイムラインヘルパー用
PVS_HOME/_template/video/video/すべての新しいビデオの開始点となるサンプルのbuild.py、template.tpl、app.css

Individual skills in this repo

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

josueh04/product-video-skills

Extract, once per product, everything every video of it reuses and write it to kit/ and product.yaml (design tokens, font subsets as woff2, icon subsets as SVG from the product's own icon packages, logos in light, dark and app-tile variants from the repo, a fictional cast proposed once for veto and then frozen, the canonical-names map, pronunciations, banned terms and the read-only tool list). Use it when a product is set up or its kit is missing or incomplete, when a video needs an icon, font or logo that is not in kit/ yet, when someone asks for demo names, fake customers, phone numbers or emails, when a brand word is mispronounced or an old product name shows up, and when checking that demo data is fictional.

josueh04/product-video-skills

Interview the user about a product, then create products/<slug>/ with its own git history, a filled product.yaml and linked skills, fetch its sources and build its kit. Run only when the user types /product-new.

josueh04/product-video-skills

Back every sentence of a video's narration (audio/lines.tsv) and every screen it shows with a citation into the pinned source code (role/path:line@sha) or a docs URL, mark what is visible in the UI versus backend-only, flag restricted or unreleased features, and cut or rewrite anything unbacked; writes the video's TRUTH.md and checks it with truth_check.py. Use it whenever a script or narration is drafted or edited, before voice is generated, before a build, when someone asks "can we say this?", "is this true?", "does the product really do X?", when a reviewer asks for a feature or a claim the product may not support, and when a source document (pitch deck, PRD, marketing page) makes claims the video wants to repeat.

josueh04/product-video-skills

Check a rendered product video before anyone else sees it: worker-pattern flicker, black frames, loudness and true peak, clipping, clicks at clip edges, overlapping narration, speech to text against the script, banned terms and legacy names, camera zoom, contact sheets, frame strips at transitions and parity against the approved version; then write qa/REPORT.json, the only thing deliver.py accepts. Use it after every HyperFrames render, whenever someone asks "is the render clean", "QA this", "check the video", "check the audio", "why does it flicker", "there is a click", "compare v3 with v2", "did the approved part change", or before showing, sending, uploading or delivering any MP4, even when the request does not say QA. Also use it to triage a defect a reviewer reported in a render.

josueh04/product-video-skills

Write a product video's narration and turn it into voice clips with word timings, pronunciation fixes, sound effects and even loudness. The script becomes a table of moments and then audio/lines.tsv (one clip per sentence, with role and speed columns); tts.py voices it with ElevenLabs or the free macOS say voice, maps brand respellings back to the on-screen spelling, normalizes every clip and writes audio/timings.json for the composer; make_sfx.py builds typing tracks from real keystrokes and places recorded click and pop sounds. Use it whenever a video needs a script, narration, voice-over, lines.tsv, timings.json, TTS, a new take, a voice or casting choice, a pronunciation fix ("it says the name wrong"), a changed sentence, a tone note ("too hype", "sounds cut off"), audio levels, a click at the end of a clip, typing or click sounds, or when the build stage asks for the voice. Also use it for silent loops, which still need a moment table and SFX.

josueh04/product-video-skills

The animation rules that keep HyperFrames' parallel render workers from dropping, flashing or flickering elements, plus a static lint (lint_motion.py) that finds the violations in a video's template before it costs a render. Use it whenever you write or edit GSAP tweens, timelines, cursors, camera moves, typing, scrolls or pop-ups in a HyperFrames composition or a video's src/template.tpl, whenever a render shows flicker, stutter, an element that vanishes on some frames, a title that flashes, or a "WORKER PATTERN" line from scan_render.py or qa.py, and whenever the preview looks right but the MP4 does not. Also use it to review someone else's timeline code before rendering.

josueh04/product-video-skills

Pin a product's source code (read-only exports in sources/ plus sources.lock), confirm that the pinned commit is what runs in production, and map every screen of a video brief to its route, components, i18n strings and state, written to the video's SOURCES.md. Use it whenever a video needs to know where a screen lives in the code, when sources/ is missing or stale, before ui-spec-from-code or product-truth start on a video, after the product's frontend changed ("what changed", "which videos are affected", "refresh the sources", "is this checkout current", "which commit is in prod"), and when there is no code and you need an inventory of the no-code references (recordings, recovered captures, docs) a screen can be rebuilt from.

josueh04/product-video-skills

Gather pixel references for UI that the code cannot show, or to check a rebuild against the real thing, using frames and timed OCR text from screen recordings, captures recovered from past Claude Code session transcripts, a local instance of the app built like production, and web research for third-party apps, plus side-by-side parity images and contact sheets. Use it whenever someone hands over a screen recording (.mov or .mp4) of the product, when a screen has no usable source code (a stale checkout, another company's UI such as a sign-in page, calendar or CRM, runtime output from a backend not in the repos), when asked "what does it really look like", "match the recording", "how long does that animation take in the app", "compare our render to the real app", or when screenshots from an earlier session might already exist. Never uses the reviewer's personal browser.

josueh04/product-video-skills

Turn a product's real frontend code into 1:1 rebuild specs for a video, one read-only subagent per screen, each returning static HTML, CSS with every variable resolved to its literal value and cited (role/path:line@sha), every state, transitions with exact durations and easings, icons from the code's own icon sets, and the exact i18n strings; plus resolve_tokens.py to write the product's design tokens to kit/tokens.css. Use it whenever a screen of the product has to appear in a video, when writing or fixing video/src/app.css or the template markup, when someone asks for exact sizes, colors, fonts, paddings, animations or icons of a screen, when a rebuilt screen "looks off" next to the real app, and when the design tokens or theme of a product need extracting. Framework adapters cover Angular with PrimeNG (proven), React, Vue, Tailwind and plain HTML (unproven).

josueh04/product-video-skills

Say where this session stands in the Product Video Skills workbench (setup state, which product and video the current folder belongs to, the stage of every video) and the exact next command to type. Also answers "how do I..." questions about the workbench from its docs.

josueh04/product-video-skills

Coordinate the build of one or more signed videos of the current product with subagents (source recon, product truth, UI specs, voice, one builder per video), re-run QA itself, then deliver. A light coordinator that never builds itself. Run only when the user types /video-build.

josueh04/product-video-skills

Start a new video of the current product - create videos/<video>/, write BRIEF.md, the feature coverage matrix (COVERAGE.md) and the claims sheet (CLAIMS.md), propose chapters, then stop for the reviewer's sign-off. Never builds. Run only when the user types /video-new.

josueh04/product-video-skills

Turn a batch of reviewer feedback on the product's videos into one table per video, fix every video that got notes in parallel (one subagent each) while keeping approved parts, re-run QA and parity, bump versions and deliver. Run only when the user types /video-review.

josueh04/product-video-skills

Check this machine and install the pinned video toolchain of the Product Video Skills workbench (HyperFrames CLI, its rendering Chrome and its agent skills from the same release, the Python environment, the speech model for QA), then run the self-check. Safe to run again. `/video-setup check` only reports.

関連スキル