Communitygithub.com

assafkip/claude-video-editor

HyperFrames CLIツール — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark。プロジェクトのスキャフォールディング、コンポジションのリント・検証、スタジオでのプレビュー、動画レンダリング、音声文字起こし、TTS生成、HyperFrames環境のトラブルシューティングに使用します。

claude-video-editor とは?

HyperFrames CLIは、動画編集ワークフローを自動化するコマンドラインツールです。Node.js >= 22 と FFmpeg を環境に要求し、`npx hyperframes` で全ての操作を実行します。スキャフォールディング(`init`)、リント(`lint`)、プレビュー(`preview`)、レンダリング(`render`)といった一連の工程をサポートし、音声文字起こし(`transcribe`)やテキスト読み上げ(`tts`)機能も内蔵しています。さらに、環境診断(`doctor`)やアップグレード確認(`upgrade`)などの補助コマンドも提供します。このスキルはClaude Codeエージェント向けに設計されており、開発者は自然言語の指示で動画プロジェクトを迅速に立ち上げ、品質をチェックし、最終的な動画出力までをシームレスに実行できます。

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

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

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

ドキュメント

HyperFrames CLI

すべての操作は npx hyperframes を通して実行します。Node.js >= 22 と FFmpeg が必要です。

ワークフロー

  1. スキャフォールディング — npx hyperframes init my-video
  2. 作成 — HTMLコンポジションを作成(hyperframes スキルを参照)
  3. リント — npx hyperframes lint
  4. プレビュー — npx hyperframes preview
  5. レンダリング — npx hyperframes render

プレビューの前にリントを実行してください。data-composition-id の欠落、トラックの重複、未登録のタイムラインなどを検出します。

スキャフォールディング

npx hyperframes init my-video                        # 対話型ウィザード
npx hyperframes init my-video --example warm-grain   # サンプルを選択
npx hyperframes init my-video --video clip.mp4        # 動画ファイルを指定
npx hyperframes init my-video --audio track.mp3       # 音声ファイルを指定
npx hyperframes init my-video --non-interactive       # プロンプトをスキップ(CI/エージェント向け)

テンプレート: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph

init は適切なファイル構造を作成し、メディアをコピーし、Whisper を使って音声を文字起こしし、AIコーディングスキルをインストールします。手動でファイルを作成する代わりに使用してください。

リント

npx hyperframes lint                  # カレントディレクトリ
npx hyperframes lint ./my-project     # 特定のプロジェクト
npx hyperframes lint --verbose        # 情報レベルの検出結果も表示
npx hyperframes lint --json           # 機械可読形式

index.html と compositions/ 内の全ファイルをリントします。エラー(修正必須)、警告(修正推奨)、情報(--verbose 時)を報告します。

プレビュー

npx hyperframes preview                   # カレントディレクトリをサーブ
npx hyperframes preview --port 4567       # カスタムポート(デフォルト3002)

ファイル変更時にホットリロードします。ブラウザでスタジオが自動的に開きます。

レンダリング

npx hyperframes render                                # 標準MP4
npx hyperframes render --output final.mp4             # 出力ファイル名指定
npx hyperframes render --quality draft                # 高速イテレーション
npx hyperframes render --fps 60 --quality high        # 最終納品
npx hyperframes render --format webm                  # 透明対応WebM
npx hyperframes render --docker                       # バイト一致
フラグオプションデフォルト備考
--outputパスrenders/name_timestamp.mp4出力パス
--fps24, 30, 603060fpsはレンダリング時間が2倍
--qualitydraft, standard, highstandarddraft はイテレーション用
--formatmp4, webmmp4WebMは透明対応
--workers1-8 または autoauto各ワーカーがChromeを起動
--dockerフラグoff再現可能な出力
--gpuフラグoffGPUアクセラレーションエンコード
--strictフラグoffリントエラーで失敗
--strict-allフラグoffエラーと警告の両方で失敗

品質ガイダンス: イテレーション中は draft、レビューは standard、最終納品は high を使用してください。

文字起こし

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # 既存の字幕をインポート
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

テキスト読み上げ(TTS)

npx hyperframes tts "テキストここに入力" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # 全ボイスを表示

トラブルシューティング

npx hyperframes doctor       # 環境をチェック(Chrome, FFmpeg, Node, メモリ)
npx hyperframes browser      # バンドルされたChromeを管理
npx hyperframes info         # バージョンと環境の詳細
npx hyperframes upgrade      # アップデートを確認

レンダリングに失敗した場合は、最初に doctor を実行してください。よくある問題: FFmpeg未インストール、Chrome未インストール、メモリ不足。

その他

npx hyperframes compositions   # プロジェクト内のコンポジション一覧
npx hyperframes docs           # ドキュメントを開く
npx hyperframes benchmark .    # レンダリングパフォーマンスのベンチマーク

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

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.

関連スキル