Communitygithub.com

assafkip/claude-video-editor

静止画から動画を構築するスキルです。カットする映像がない場合に、ナレーション(ElevenLabs v3とオーディオタグ)を先に生成し、任意のソース(AI画像生成ツール、スクリーンショット、写真、HyperFramesでレンダリングしたHTMLなど)から静止画キーフレームを取得し、animate-stillsレシピ(HyperFramesのカメラワーク+GSAPの雰囲気エフェクト)で決定論的にアニメーション化します。解説動画、ドキュメンタリースタイルの動画、または録画映像ではなく生成・収集したビジュアルから動画を作成したい場合に使用します。

claude-video-editor とは?

このスキルは、録画済みの映像がない状況で、生成または収集した静止画(キーフレーム)とナレーションを組み合わせて動画を構築するためのパイプラインです。まずElevenLabs v3で音声を生成し、そのトランスクリプトから文単位のタイムスタンプを取得します。次に、AI画像生成、スクリーンショット、写真、さらにはHyperFramesでレンダリングしたHTMLなど、あらゆるソースから1シーンにつき1枚の静止画キーフレームを収集します。最後に、HyperFramesの`animate-stills`レシピを用いて、これらの静止画にカメラのプッシュインやドリフトなどの動きと、GSAPによる霧や雨、光の変化といった雰囲気エフェクトを加え、決定論的にアニメーション化します。このパイプラインは、外部の画像生成ツールに依存せず、ローカルで再現可能な動画生成を実現します。

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

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

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

ドキュメント

generate-footage

このプラグインのもう一つのエントリーポイントです。video-use はすでに存在する映像を編集します。このスキルは、まだ存在しない映像——ナレーションと静止画キーフレームを、HyperFramesで構成・アニメーション化し、決定論的にレンダリングすることで動画を構築します。

パイプライン(プロダクションで実証済み。モーションステップがなぜ決定論的なのかは docs/rca/ を参照):

スクリプト(v3オーディオタグ付き)
  → eleven_v3 ナレーション            (scripts/tts_v3.py)
  → 文字起こし                       (npx hyperframes transcribe narration.mp3)
  → シーンウィンドウを文の境界にロック(単語レベルのタイムスタンプ)
  → 任意のソースからの静止画           (1シーンにつき1枚のキーフレーム — 以下参照)
  → animate-stills コンポジション     (recipes/04-animate-stills.md, build_scenes.py)
  → リント → レンダリング → モーション+音声 QA (scripts/motion_check.py, コンタクトシート)

順序が重要:音声を先に、ビジュアルは後

コンポジションを構築したりキーフレームを収集する前に、ナレーションを生成し文字起こしを行ってください。発話された文の境界がそのままシーンウィンドウになります。v3の読み上げはペーシングが非決定論的であり、120秒の見積もりが実際には100秒や166秒になることがあるため、先にビジュアルを構築すると、後で必ずタイミングの再調整が必要になります。

ナレーション — ElevenLabs v3とオーディオタグ

scripts/tts_v3.py — 標準ライブラリのみで動作し、pip依存関係はありません。APIキーは $ELEVENLABS_API_KEY またはプラグインの skills/video-use/.env から読み取ります。

python3 scripts/tts_v3.py --probe                      # eleven_v3の確認+音声一覧表示
python3 scripts/tts_v3.py --voice <id> --stability 0.0 --script SCRIPT.md --out narration.mp3
  • オーディオタグはスクリプトテキスト内に記述します:[excited]、[whispers]、[softly]、 [dramatic tone]、[warmly]。v3はこれらを実行し、v2は無視します。
  • 安定性:0.0 = クリエイティブ(最大表現力)、0.5 = ナチュラル、 1.0 = ロバスト。読み上げが「フラット」な場合は、語彙を強くするのではなく、安定性を下げてスクリプトにタグを再設定することで修正します。
  • 演出のレバー:強調したい単語を大文字で、... で劇的な間、コントラスト(大きなセリフの直前に [whispers] に切り替え)。
  • 最初の文で2〜3の音声を試聴してから決定します。最初の音声が採用になることはまずありません。
  • v3はわずかに言い換えることがあります。結果を文字起こしして読み、キーとなるラインがずれていたら再生成してください。

任意のソースからの静止画

キーフレームは単なるPNGファイルです。パイプラインはそのソースを気にしません。シーンごとに1枚の静止画を kf-NN.png という名前で用意し、シーンマニフェストにリストします(スキーマは recipes/04-animate-stills.md に記載)。使用可能なソース:

  • AI画像生成ツール — すでに持っているテキスト-to-画像ツール(Gemini、 GPT画像生成、Midjourney、ローカルSD、またはホステッドアクター — 最後のオプションセクションを参照)。シーンごとのプロンプトに、固定したスタイルサフィックスを付けて生成します。
  • スクリーンショットと写真 — 製品UIのキャプチャ、アーカイブ資料、スキャン、 実際の写真。ケンバーンズ効果はこのために発明されました。
  • HyperFramesでレンダリングしたHTML — スタイル付きHTMLフレームを構築してスナップショットを撮影します。エンジンはそれ自身の静止画を生成します。

ソースに関わらず守るべきルール:

  • 1つのスタイルに固定し、DESIGN.mdに記述してすべてのフレームに適用します。フレーム間でスタイルがずれると、モーションやグレーディングが適用されたときに別のショットとして認識されます。
  • ファイルタイプを確認する。 一部のツールは.pngという名前のJPEGを提供します。コンポジションの前にマジックバイトを確認してください(file kf-01.png)。
  • すべてのフレームをQAする(画像を読むこと)。スタイルから外れたフレームが1つある場合は、保持せずに再生成します。確認事項:テキストのアーティファクト、透かし、時代錯誤、クローズアップ顔(ずれのリスク)、間違ったパレット。
  • 名前付き知的財産や実在の人物の肖像を公開投稿用の生成フレームに使用しないでください。

アニメーション — 決定論的、リポジトリ内

静止画はanimate-stillsレシピ(recipes/04-animate-stills.md)によって動きになります。これはマニフェスト駆動型のHyperFramesコンポジションであり、各静止画にカメラ言語(プッシュイン、ドリフト、ホールド)とGSAPアトモスフィア(霧、雨、光の変化、ビネット)を適用し、シーンウィンドウはトランスクリプトにロックされます。scripts/build_scenes.py がマニフェストからシーンレイヤーを生成し、scripts/motion_check.py がレンダリング出力のピクセル差分によって実際のモーションを証明します。毎回同一にレンダリングされ、コストはかからず、オフラインでも動作します。

HyperFrames CLIを使用するにはNode >= 22が必要です。

キャプションとアセンブリ

  • キャプションは焼き付けられます(Reddit/Xでのミュート自動再生用)、フレーズレベル、トランスクリプトの単語からタイミングを取得。
  • ストーリーの転換点ではホワイトフラッシュ(0.28秒)、その他はソフトクロスフェード。ダークビネットグレードが異なるソースの静止画を統一し、キャプションを読みやすくします。
  • レンダリング内のモーションを確認:1つのシーン内で4秒離れた2フレームのピクセル差分を取ります(scripts/motion_check.py — 平均グレー差分 > 3 で実際のモーションと判断)。
  • 音声QA:ffmpeg -af volumedetect — ドキュメンタリー音声は平均 -26 dB 付近が適切です。

オプション:ホステッド生成ツール

これらは依存関係ではありません。静止画やクリップを入手するためのいくつかの方法のうちの1つであり、予告なく利用できなくなる可能性があります。それに備えて計画してください。

  • Apifyのテキスト-to-画像アクター(例:akash9078/ai-image-generator、 ~$0.01/画像)はバッチキーフレーム生成に有効でした。サイレント障害(ok:true だがURLがnull)や誤ったファイルタイプに注意してください。
  • ホステッド画像-to-動画アクターは、このパイプラインが以前モーションステップを保持していた場所です。2026-06-11、アクター danitn11/wan22-lightning-image-to-video (合計2ユーザー)が上流で稼働停止し、すべての実行が即座に失敗しました。完全な分析は docs/rca/rca-generate-footage-animation-2026-06-11.md にあります。生成型画像-to-動画は現在、プラグ可能なBYO-keyバックエンドを持つ別のコンパニオンリポジトリに存在します。このプラグインのモーションステップは決定論的かつローカルです。

Individual skills in this repo

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

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

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

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.

関連スキル