Communitygithub.com

assafkip/claude-video-editor

初心者向けのエンドツーエンド動画作成ツール(HyperFrames対応)。「動画を作って」「新しい動画」「動画をゼロから」などのリクエストに応え、1回のインタビューで企画を固め、プレビューと視覚確認を必須とした本格的なMP4動画を生成します。

claude-video-editor とは?

このスキルは、HyperFramesフレームワーク上で動作する、初心者から完成度の高いMP4動画までを一貫して作成するためのエンドツーエンドスキルです。ユーザーが「動画を作りたい」「動画をゼロから作りたい」と発言した場合や、HyperFramesを初めて使うユーザーがコンセプトやスクリプト、大まかなアイデアを元に動画を完成させたい場合に自動的に呼び出されます。スキルは「インタビューフェーズ(ゲート1~4)」と「ビルドフェーズ(ゲート5~8)」の2フェーズ、8つのシーケンシャルなゲートで構成されています。各ゲートは具体的な成果物を生成し、次のゲートがそれを消費するため、ゲートのスキップは禁止されています。インタビューフェーズでは、ユーザーに一度に複数の質問をせず、意図、フォーマット、スクリプト、音声、スタイル、アセット、ペーシングを漏れなくヒアリングし、BRIRF.mdとしてまとめ、ユーザーの明示的な承認を待ちます。ビルドフェーズでは、プロジェクトのスキャフォールディング、ストーリーボードの作成、コンポジションのビルド(GSAPアニメーション使用)、リンターによるチェック、スタジオプレビュー、ドラフトレンダリング、フレーム抽出による視覚確認、MP4プレビューを経て、最終レンダリングを実行します。特に、スタジオプレビュー(プレビューゲート1)とレンダリングされたMP4プレビュー(プレビューゲート2)の2つの確認ゲートは必須であり、スキップは許可されていません。また、レンダリングが完了したと主張する前に、必ずフレームを抽出してReadツールで視覚確認を行うことが厳格にルール化されています。このスキルはHyperFrames環境を前提としており、関連スキルとして`/hyperframes`(フレームワークルール)、`/short-form-video`(9:16縦型トークヘッド形式へのハンドオフ)などが定義されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/skills/make-a-video

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

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

ドキュメント

動画作成 — 初心者から完成MP4までのスキル

2つのフェーズ、8つのシーケンシャルゲート。各ゲートは具体的な成果物を生成し、次のゲートがそれを消費します。ゲートをスキップしないでください。

このスキルを使用するタイミング — そしてハンドオフするタイミング

このスキルを使用するタイミング:

  • ユーザーがHyperFramesを初めて使用し、コンセプト、スクリプト、またはアウトラインから開始する場合
  • ユーザーがエンドツーエンドのウォークスルーを希望し、フレームワークのリファレンス資料を求めていない場合
  • ユーザーがまだフォーマットを決めていない場合

ハンドオフするタイミング:

  • ユーザーがURLを貼り付け、そのサイトから動画を作成したい場合 → /website-to-hyperframes を呼び出す
  • ユーザーが明示的に9:16縦型トークヘッド(顔カメラ+シーンオーバーレイ)を希望する場合 → ゲート1~4を実行し、ゲート5以降は /short-form-video を呼び出す
  • ユーザーが動画ではなくフレームワークのルールを尋ねてきた場合 → /hyperframes を呼び出す

2つのフェーズ

  • フェーズ1 — インタビュー(ゲート1~4): コードに触れる前にすべてを収集するための1回の会話パス。意図、フォーマット、スクリプト、音声、スタイル、アセット、ペーシング。BRIEF.md にまとめ、明示的な承認を待ちます。
  • フェーズ2 — ビルド(ゲート5~8): スキャフォールド → ストーリーボード → コンポジション → リンター → スタジオプレビュー → ドラフトレンダリング → 視覚確認 → MP4プレビュー → 最終レンダリング。

ゲート1 · 意図とフォーマット

AskUserQuestion を使用して一度に1つの質問をし、可能な限り選択式にします。

  1. この動画の目的は?(プロモーション · ソーシャル広告 · ローンチティーザー · 製品デモ · チュートリアル · 解説 · イントロ/アウトロカード · その他)
  2. ターゲット視聴者は?(自由記述)
  3. 目標尺は?(10~20秒のショート · 20~45秒のプロモーション · 45~90秒の解説 · 1.5~3分のレッスン · カスタム)
  4. アスペクト比は?(16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. フレームレートは?(30 デフォルト · 60 crispなUI · 24 シネマティック)
  6. プラットフォーム/配信制約は?(ファイルサイズ · 期限 · 再生環境)

ゲート条件: 上記6つすべてを取得。回答が9:16+顔カメラの場合、ゲート5で /short-form-video へのハンドオフを計画します。

全質問バンク: Read: references/interview-questions.md


ゲート2 · スクリプトと音声

  1. スクリプトのソースは?(ペースト · アウトライン → 私が下書き · 私が録音 · テキストからTTS · ナレーションなし)
  2. TTSの場合:音声の好み。npx hyperframes tts --help から選択肢を提示。ペースも取得。
  3. 顔カメラの場合:録画パス · フルスクリーンかコーナー配置か · 文字起こしが必要か?(npx hyperframes transcribe <file> --model small.en --json)
  4. キャプション?(オフ · ハイプ · コーポレート · カラオケ単語単位 · ミニマル)

ゲート条件: スクリプト(または下書き)取得、音声計画取得、キャプション計画取得。


ゲート3 · スタイルインテーク

ユーザーに質問する前に、既存のアセットを棚卸しします。 <workspace-root>/assets/ とプロジェクトの assets/ フォルダを確認します。すでにあるものを尋ねないでください。

その後、段階的に質問します — すべてに答える必要はありません:

  1. スタイルガイドやブランドドキュメントは?(パスをペースト · なし)
  2. カラーパレットは?(16進数コード · なし — MOTION_PHILOSOPHYのデフォルトを使用)
  3. フォントは?(Google Fonts名 · ファイルパス · なし — Inter + JetBrains Monoのデフォルトを使用)
  4. ロゴファイルは?(パス · なし — 代わりにテキストワードマークを使用)
  5. 雰囲気の参考動画は?(URL/パス · なし)
  6. その他のアセットは?(スクリーンショット · 商品写真 · Bロール · 音楽 — パスをリスト)
  7. MOTION_PHILOSOPHYの美学(黒いキャンバス · クロームタイプ · パースペクティブグリッド · ホイップトランジション)または別の雰囲気?
  8. ペーシングは?(キネティック 1~2秒 · バランス 2~3秒 · リラックス 3~5秒)
  9. 音楽は?(なし · アンビエントパッド 0.15 · 音楽ベッド 0.4 · フル 0.8 — 持っている場合はファイルパス)
  10. アウトロ/コールトゥアクションテキストは?

ユーザーにブランドを押し付けないでください。 ユーザーがスタイルの提供を明示的に辞退した場合にのみ、MOTION_PHILOSOPHYのデフォルトにフォールバックします。

完全なスタイルフロー+MOTION_PHILOSOPHYデフォルト: Read: references/style-intake.md


ゲート4 · ブリーフ統合(ビルド前のハードゲート)

  1. MOTION_PHILOSOPHY.md を読む — ワークスペースルートに存在する場合は必須。存在しない場合は、references/style-intake.md のデフォルトで進め、その旨をブリーフに記載します。
  2. プロジェクトの保存場所を尋ねる(自明でない場合):
    • video-projects/ が存在する場合 → video-projects/<スラッグ>/ を使用
    • それ以外の場合 → ユーザーに尋ねる
  3. <project-folder>/BRIEF.md を書く:
    • スラッグ · 意図 · 視聴者 · 寸法 · fps · 尺
    • スクリプト(全文またはアウトライン)
    • 音声選択 · キャプション計画 · 顔カメラ計画
    • スタイルプロファイル:パレット(16進数)、フォント、ロゴパス、参考動画
    • ペーシング
    • アセットインベントリ(パス付き)
    • アウトロ/CTAテキスト
  4. ブリーフを表示。明示的な承認を待つ。 「はい、作ってください」という明確な承認なしにゲート5に進まないでください。

ゲート5 · スキャフォールドとストーリーボード

まずハンドオフチェック

ブリーフが9:16縦型トークヘッド(顔カメラ+シーンオーバーレイ)を説明している場合、今すぐ /short-form-video を呼び出し、ブリーフを引き渡します。このスキルの4層スキャフォールドはそのフォーマット用に設計されています。

それ以外の場合は続行:

スキャフォールド

  1. mkdir <project-folder>
  2. 同様のフォーマットの兄弟プロジェクトが存在する場合、その hyperframes.json + meta.json をテンプレートとしてコピーすることを提案します。それ以外の場合はフォルダ内から: npx hyperframes init
  3. meta.json をユーザーのスラッグ、寸法、fpsで編集します。
  4. 提供されたアセットを <project-folder>/assets/ にコピーします。
  5. ゲート3から <project-folder>/assets/style-profile.md を作成 — パレット/フォント/ロゴの単一情報源。

ストーリーボード

references/storyboard-template.md のテンプレートを使用して <project-folder>/STORYBOARD.md を生成します。すべてのビートは以下を取得します:

ビート N — タイトル(開始–終了、尺) — 一行でのコンセプト
視覚要素: [各要素、サイズ、アニメーション、タイミング]
モーション言語: [動きの種類]
使用イーズ: [3~4つの異なるGSAPイーズ]
終了: [次のビートへのトランジション]
オーディオ: [VOライン / SFX / 音楽レイヤー]

ファイルの先頭:シーン · 開始 · 尺 · コンポジションファイルのタイミングテーブル。

3幕構成を提案:

  • 第1幕(フック)≈ 尺の20%
  • 第2幕(本編)≈ 55%
  • 第3幕(決着+4~6秒ホールドのあるアウトロ)≈ 25%

(MOTION_PHILOSOPHY §0 法則9、§1)

ユーザーの意図をカタログブロックにマッピング: Read: references/catalog-intent-map.md

ゲート条件: ストーリーボード+タイミングテーブルを表示。ユーザーが承認するまで繰り返します。


ゲート6 · コンポジションのビルド

フレームワークルールについては /hyperframes を呼び出します。このスキルはスキャフォールドと規律を担当し、/hyperframes がルールを実施します。

すべてのサブコンポジションをスキャフォールド

<div data-composition-id="scene-name" data-start="..." data-duration="...">
  <style>[data-composition-id="scene-name"] { /* スコープ化 */ }</style>
  <!-- DOM -->
  <script>
    (function(){
      const SLOT_DURATION = ...;
      const tl = gsap.timeline({ paused: true });
      // ... トゥイーン ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // アンカー — MOTION_PHILOSOPHY 法則11
      window.__timelines["scene-name"] = tl;
    })();
  </script>
</div>

完全なボイラープレート+キャプションパターン+アンビエント背景パターン: Read: references/composition-scaffold.md

ビルドルール

  • アンビエント背景 は、コンポジション全体の期間中 data-track-index="0" で設定。
  • キネティックタイプオープナー: 単語ごとに0.06~0.10秒のスタッガー。
  • キャプション は、index.html のルートコンポジションのボディレベルの兄弟要素として配置し、それぞれ data-track-index >= 20 を設定。シーンタイムライン内には決して配置しない(MOTION_PHILOSOPHY §3.13)。
  • カタログブロック は npx hyperframes add <名前> でインストール。すぐにブロックのCSSを [data-composition-id="..."] にスコープ化 — カタログブロックには html, body { ... } ルールが含まれており、サブコンポジションとしてロードされると親ドキュメントに影響を及ぼします。
  • 縦型+顔カメラ: ネイティブの1920×1080の顔をトランスフォーム(translate + scale)でラップし、下半分またはフルスクリーンモードに。 (ここで /short-form-video にたどり着いた場合は、ハンドオフを強く検討。)
  • ユーザーが提供したものだけを適用。 ユーザーのパレット、フォント、ロゴ。それ以外は注入しない。ユーザーがMOTION_PHILOSOPHYのデフォルトを選択した場合は、references/style-intake.md からパレット+フォントペアを取得。

決定性

Math.random()、Date.now()、レンダリング時の fetch() は使用しない。シード付きPRNGまたは調和サイン(harmonic-sin)ハッシュを使用する(MOTION_PHILOSOPHY §3.10)。


ゲート7 · リンター → スタジオプレビュー(プレビューゲート1 — 必須)

  1. npx hyperframes lint — すべてのエラーを修正し、警告をトリアージ。
  2. バックグラウンドで npx hyperframes preview を実行。
  3. http://localhost:3002 で「Studio running」が表示されるのを待つ。
  4. ユーザーにURLを提示および個々のコンポジションURL(http://localhost:3002/?comp=<id>)も提示。プロジェクトにWebGLシェーダーブロックがある場合は、個別URLを最初に提示 — ソフトウェアWebGLフォールバックはマスターコンポジションを停止させる可能性があります。
  5. 「良さそうだ、ドラフトをレンダリングして」という明示的な承認を待つ まで先に進まない。沈黙は承認ではありません。

ホットリロードはオン — 編集はライブで反映されます。


ゲート8 · ドラフトレンダリング → 視覚確認 → MP4プレビュー → 最終

ドラフトレンダリング

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

視覚確認(納品前に必須)

リンター合格 ≠ デザイン動作。フレームを抽出して確認します。

  1. mkdir -p renders/frames
  2. すべてのビートの見せ場およびすべてのトランジションについて:
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. すべてのPNGに対して Read ツールを呼び出す。 Readツールは画像をコンテキストに読み込みます — ファイル名をリストするだけでは不十分。
  4. フレームごとに確認:顔が途切れていないか、シーンごとに正しいフェイスモードか、テキストが読みやすくパレットに合っているか、オーバーフローがないか、トランジションが意図した単語に合っているか、空白フレームがないか。
  5. 問題がある場合:修正 → 再レンダリング → 再確認。壊れたドラフトを決して出荷しない。

MP4プレビュー(プレビューゲート2 — 必須)

npx serve renders -p 8080 -n

Pythonの http.server を使用しない — HTTP Rangeリクエストをサポートしていないため、シークが壊れます。

ユーザーに http://localhost:8080/<slug>-draft.mp4 を提示。再生とオーディオ同期について明示的な承認を待つ。

最終レンダリング

npx hyperframes render --quality standard --output renders/<slug>-final.mp4

出力パスを報告。完了。

完全なプレフライト+納品前チェックリスト: Read: references/build-checklist.md


非交渉事項(重要 — 軽く扱わないこと)

  • プレビューゲート1(スタジオ)またはプレビューゲート2(レンダリング済みMP4)をスキップしない。 ビルドごとに常に2つのゲート。
  • フレームを抽出し、Readツールで確認するまで、レンダリングが完了したと主張しない。
  • 専用のプロジェクトフォルダ以外ではビルドしない。 ワークスペースルートに index.html を置いてはいけません。
  • ワークスペースのアセットを棚卸しする前に、ユーザーにアセットを尋ねない。
  • すべてのサブコンポジションタイムラインの最後に tl.to({}, { duration: SLOT_DURATION }, 0) アンカートゥイーンをスキップしない。 MOTION_PHILOSOPHY 法則11。
  • レンダリングロジック内で Math.random() / Date.now() を使用しない。 シード付きハッシュのみ。
  • <video> タグに class="clip" を追加しない。 それらが壊れます。
  • ユーザーにブランドを押し付けない。 最初に尋ね、ユーザーが明示的に辞退した場合のみMOTION_PHILOSOPHYのデフォルトにフォールバック。

参考文献

  • references/interview-questions.md — ゲート別の全質問バンク
  • references/style-intake.md — スタイルインタビュー+MOTION_PHILOSOPHYデフォルト
  • references/catalog-intent-map.md — 「ユーザーがXと言った → Yをインストール」
  • references/storyboard-template.md — ビート単位のテンプレート+実例
  • references/composition-scaffold.md — スコープ化スタイル+IIFE GSAPボイラープレート
  • references/build-checklist.md — プレフライト+納品前ゲート

外部(ワークスペースレベル):

  • MOTION_PHILOSOPHY.md — このスキルが存在を前提とする唯一の外部参照。美的ベースライン。ファイルがない場合のフォールバックは references/style-intake.md にあります。

関連スキル

  • /hyperframes — フレームワークルール、ゲート6で呼び出す
  • /hyperframes-cli — init · lint · preview · render · transcribe · tts
  • /hyperframes-registry — カタログブロックのインストール
  • /gsap — GSAPアニメーションリファレンス
  • /short-form-video — ゲート5で9:16トークヘッド形式へのハンドオフ
  • /website-to-hyperframes — 入力がURLの場合、ゲート1でハンドオフ

Individual skills in this repo

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

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

assafkip/claude-video-editor

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

assafkip/claude-video-editor

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

assafkip/claude-video-editor

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

assafkip/claude-video-editor

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

関連スキル