learnaiwithhugo/video-editor-skills

/new-edit-style

参考リールを入力として、ロックされた/<style>-editスキルを出力します。これにより、そのスキルを使って行うすべての編集が参考リールのように仕上がります。これは/kallaway-editを構築したプロセスを文書化し、洗練させたものです。通常、使用する人は技術に詳しくありません。平易な英語で、1ステップにつき1つの短いメッセージを送り、コードに触れさせることは絶対に避けてください。

SK = ${CLAUDE_SKILL_DIR}、このスキルのフォルダ。ENGINE = ${CLAUDE_SKILL_DIR}/../kallaway-edit、基盤となる実績のある編集スキル（セットアップウィザード、文字起こし、カット、カットアウト、サウンド、ビルド、レンダリング、QAを備えています）。SKやENGINEに書き込まないでください。アップデートにより両方が置き換えられます。 DATA = $HOME/.claude-video-editor、アップデート後も存続するエディター自身のフォルダ（設定、Python、効果音、フォントキャッシュ）。ROOT = プロジェクトフォルダ（DATA/config.jsonのprojectRoot）。 すべてのスクリプトは以下のいずれかを介して、記述されたとおりに正確に実行し、ユーザーの設定が見つかるようにします。 PY = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" "$HOME/.claude-video-editor/venv/bin/python" -I SYS = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" python3 -I（セットアップ実行前） STYLE = 短いケバブケースの名前（例：「kallaway」）。SDIR = ROOT/references/<STYLE>/。 WORK = ROOT/work/new-edit-style/<STYLE>/（進捗PNGはWORK/progress/に番号付きで配置）。

厳格なルール

• 無料ツールのみ（ffmpeg、Python、faster-whisper、HyperFrames、OFLフォント）。有料APIやサインインは禁止。ダウンロードリンクはログアウト状態で取得（yt-dlp --no-cookies）。ブラウザのクッキーは絶対に使用しないこと。
• ユーザーの元のファイルには絶対に触れない。何も削除しない（古いバージョンはROOT/archive/に移動）。
• npx hyperframes initやnpx hyperframes skillsは絶対に実行しない。~/.claude/skillsや~/.agents/skillsに何も追加してはならない。
• 推測を測定値として提示したり、音を聞いたかのように提示したりしてはならない。エージェントは音を聞くことができません。ユーザーの耳チェックが最終判断を下します。
• 編集スタイルをコピーすることは問題ありませんが、クリエイターの映像、ロゴ、音楽、テキストを編集にコピーしてはなりません。
• サブエージェント：各参考リールの分析に1エージェント（Sonnetで可）、最大3つまで同時実行、references/breakdown-brief.mdで指示。判断や目視が必要なことはすべて自分で行うこと。

ワークフロー

0. セットアップ（初回のみ）

DATA/config.jsonに"setupComplete": trueがない場合、まずエディターのセットアップウィザードを実行します。kallaway-editスキルをsetup引数で呼び出すか（またはENGINE/SKILL.mdのステップ0を参照。${CLAUDE_SKILL_DIR}はENGINE、$HOME/.claude-video-editorはDATAを意味します）、Claude Codeのチェック、ツールのチェック、プロジェクトフォルダ、インストールを実行します。ENGINEが見つからない場合は、次のように伝えます。「これにはkallaway-editスキルが隣にインストールされている必要があります（編集エンジンを搭載しています）。両方をhttps://github.com/learnaiwithhugo/video-editor-skillsから再インストールし、/new-edit-styleを再度実行してください。」その後停止します。このスキルはyt-dlpも必要とします（参考リールをダウンロードするため）。そのため、初回およびそれ以降の実行時に、`SYS "ENGINE/scripts/setup.py" --check --for new-edit-styleで必ず確認してください。yt-dlpがない場合は、ユーザーに修正コマンド（brew install yt-dlp`をターミナルアプリに貼り付け）を伝え、ユーザーが完了したと言うまで待ち、再度確認します。

1. 取り込み（約2分）

1つのメッセージで尋ねます。「編集スタイルをコピーしたい1人のクリエイターのリールを2～3本（リンクまたはファイル）、理想的にはその方の好きな編集作品とスタイルの短い名前を送ってください。」3本が最適です。ルールはすべてのリールに共通するものから導き出されます。その後： SYS "SK/scripts/fetch.py" STYLE "ROOT" <link or file> ... -> SDIR/STYLE-1.mp4 ... 次のように伝えます。「取得しました。現在すべてのフレームを測定中です（約2分）。」

2. 準備、すべてスクリプト化（リールあたり約30秒）

PY "SK/scripts/prep.py" "SDIR" SDIR/STYLE-*.mp4 SDIR/prep/<reel>/内のリールごとに：ワードタイミング付き文字起こし、全フレームカットスキャン、タイムスタンプ付き4 fpsコンタクトシート、フルサイズ静止画、スペクトログラム、ステレオ効果音ヒット、ラウドネス、およびfingerprint.json（測定されたスタイル数値）。さらにSDIR/style-check.pngとSDIR/style-spec.json。 今すぐstyle-check.pngを確認してください。 1つのリールが他のリールと明らかに異なる見た目（異なるレイアウト、キャプション、色）の場合、ユーザーに伝え、エージェントを実行する前に代替リールを依頼してください。WORK/progress/01-style-check.pngにコピーします。

3. 分析、リールごとに1エージェント、並列実行（約15分）

references/breakdown-brief.mdをリールごとに一度記入し、1つのメッセージで起動します。各エージェントはSDIR/prep/<reel>/edit-log.mdに書き込みます。エージェントの実行中に、ステップ4のフォントマッチングを行います。

4. フォントマッチング（約20秒）

PY "SK/scripts/font_match.py" SDIR/STYLE-1.mp4 SDIR/prep/STYLE-1/transcripts/STYLE-1.words.json "SDIR/font" font-match.pngを確認してください。勝者が目に見えて一致している必要があります。上位2つが0.01以内の場合は、2本目のリールでも実行します。（Kallawayの場合：Archivo 800、-0.045 emでスコア0.773、Helvetica Neue Boldの0.759を上回りました。）

5. スタイルガイドへの統合（あなた、約10分）

references/merge-guide.mdに従ってください。コンセンサスルール、測定値、自分で確認するキーフレームシート、および撮影セクション。出力：SDIR/STYLE-style-guide.md + SDIR/STYLE-key-frames.png。ユーザーにキーフレームシートを開き、1段落の要約を伝えます。

6. スタイルスキルの作成（約2分 + あなたの書き換え、約30分）

SYS "SK/scripts/make_style_skill.py" STYLE "SDIR" --title "Display Name" これにより、実績のあるエンジン（ENGINE、このスキルの隣にあるもの）がROOT/.claude/skills/STYLE-edit/にクローンされます。ユーザー自身の動画フォルダ内のプロジェクトスキルであり、決してグローバルスキルフォルダには作成されません。そのため、アップデートの影響を受けません。コピーはDATAを共有します（2回目のインストールは不要）。マッチツール（scripts/match/）を追加し、測定された仕様からstyle.jsonを書き込み、スタイルガイドから書き換えるスタイルファイルのチェックリストを出力します（SKILL.mdのスタイルルール、style-rules.md、graphics-recipes.md、sound-map.md、filming-guide.md、キットCSS/JS、およびスタイルに異なるレイアウトがある場合のみbuild.pyのレイアウト）。リストのすべてのアイテムを書き換えます。エンジンスクリプトは、レイアウトが必要でない限り変更しないでください。

7. スタイルのロック（約45～60分）

references/lock.mdに従ってください。ユーザーの映像でのテスト編集 -> マッチスコア -> 修正 -> 参照ウィンドウの黄金再現 -> 修正 -> 1回の批評ラウンド -> 耳チェック -> 承認。すべての数値をSTYLE-edit/references/lock-log.mdに記録します。

8. 提供

ユーザーに伝えます。新しいコマンド（/STYLE-edit、ROOTでClaude Codeを開くたびに使用可能。まだ表示されない場合は、そこでClaude Codeを再起動してください）、1段落での機能説明、マッチスコアと黄金数値、そのスタイルで撮影する方法（撮影セクションから3～4つの箇条書き）、およびまだ一致していない点。

タイミング（M4 Pro Mac、1.5分のリール3本の場合）

取得 1分 · 準備 1.5分 · 分析 15～18分（並列） · フォントマッチング 20秒 · 統合 10分 · スキル作成 2分 + 書き換え 30分 · ロック 45～60分。全工程で約2時間、ほとんどはエージェントとレンダリングです。

ファイル

scripts/: fetch.py、prep.py、fingerprint.py（測定/仕様/スコア）、font_match.py、golden.py、make_style_skill.py、engine.py（ENGINEを検索）。references/: breakdown-brief.md、merge-guide.md、lock.md。templates/: style-rules.md、graphics-recipes.md、lock-log.md（新しいスタイルスキルにコピーされます）。