Communitygithub.com

HUANGCHIHHUNGLeo/claude-real-video

Leo의 영상 분석 도구입니다. Leo가 YouTube/IG/TikTok 링크나 로컬 비디오 파일을 던지면, 요약·분석·해체·벤치마킹을 위해 사용합니다. Claude는 직접 영상을 보지 못하므로, 이 도구가 먼저 키프레임·자막·카메라 움직임·음성/어조/제스처 타임라인을 추출하여 읽어줍니다.

claude-real-video란 무엇인가요?

이 스킬은 Leo(사용자)가 비디오 콘텐츠를 분석할 수 있도록 설계된 Pro 버전(0.5.0) 도구입니다. Claude가 직접 비디오를 처리하지 못하기 때문에, 이 도구가 비디오 URL(YouTube/IG/TikTok) 또는 로컬 파일 경로를 받아 키프레임, 자막, 카메라 움직임 패턴, 음성/어조/감정/제스처 타임라인 등 비디오의 구조적 데이터를 추출합니다. 주요 모드(시청, 제작자, 전체)와 다양한 센서(오디오 이벤트, 운율, 감정, 제스처, 장면 레이블)를 제공하며, 소셜 미디어 플랫폼(IG/TikTok)의 경우 쿠키 기반 인증을 지원합니다. 출력 순서는 MANIFEST.txt(렌즈 지시문, 프레임 목록, 모션 블록, 지각 타임라인 포함) → grids/ 폴더의 9분할 연속 프레임 → frames/*.jpg(필요시 1500px 이하로 축소) → perception.json(신뢰도가 낮아 숨겨진 지각 이벤트도 포함)입니다. 핵심 규칙: 자막은 전체를 처음부터 끝까지 읽어야 정확한 보고서를 작성할 수 있으며, 지각 태그는 참고용으로만 사용하고 반드시 프레임과 자막으로 교차 검증해야 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HUANGCHIHHUNGLeo/claude-real-video/tree/HEAD/personal-skill-backup

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

claude-real-video / crv Pro — Leoのビデオ分析

Leoのローカル環境には Pro版 0.5.0(~/Projects/crv-pro/.venv/bin/crv-pro、PATHが通っている場合は crv-pro)がインストールされています。

いつ使うか

Leoがビデオ(URLまたはファイルパス)を渡して、内容を尋ねる、要約を求める、リールを分解する、「どう話しているか」「どう撮っているか」「視聴者がなぜ購入するか」を尋ねるとき。

コマンドの選び方(0.5.0)

Leoの言葉がこんな感じコマンド
「これ何言ってる?」「要約して」「本当のこと言ってる?」crv-pro "<src>" -o out --mode watch
「どうやって作った?」「分解して」「なぜバズった?」「マネできる?」crv-pro "<src>" -o out --mode creator
「完全分析」または意図が不明瞭crv-pro "<src>" -o out --mode full

Leoが具体的な質問を持っている場合は --why "<彼の言葉>" を追加します。

  • --senses = 五感フル稼働:音声イベント、韻律曲線、感情、ジェスチャー/表情、シーンのラベル(初回実行時にモデルをダウンロード 約2.7GB、以降86秒の動画で約40秒)
  • 単一の感覚だけ必要な場合:--prosody / --audio-events / --emotion / --gesture / --scene-labels
  • --lens content|creator|both(デフォルト both)MANIFESTでAIにどの方向で分析させるかを決定します
  • 長い動画には --max-frames 60;音声なしの動画には --no-transcribe
  • IG/TikTok などのログインが必要なプラットフォーム:クッキーJSONをNetscape形式に変換して --cookies を使用します(2026-07-05 実測でIGリールを直接取得可能、これが正攻法):
    python3 -c "import json; ck=json.load(open('/Users/leo/Projects/auto-post/browse-cookies/kanisleo328-threads.json')); cs=ck if isinstance(ck,list) else ck['cookies']; print('# Netscape HTTP Cookie File'); [print('\t'.join([c['domain'],'TRUE' if c['domain'].startswith('.') else 'FALSE',c.get('path','/'),'TRUE',str(int(c.get('expirationDate',2e9))),c['name'],c['value']])) for c in cs if 'instagram' in c.get('domain','')]" > /tmp/ig-cookies.txt
    crv-pro "<reel url>" --cookies /tmp/ig-cookies.txt --mode full
    
    この方法も失敗した場合のみ、退避手段として [[reference_ig_post_full_read]] のIG内部API手動ダウンロードを使用

出力を読む順序

  1. MANIFEST.txt — 冒頭にレンズ指示ブロックがあり、それに従って実行します;フレームリスト、モーションブロック、知覚タイムライン(音声/韻律/感情/ジェスチャー/シーンイベント、各秒数と信頼度スコア付き)、トランスクリプトを含む
  2. grids/ 9分割連続フレーム;詳細を見たい場合のみ frames/*.jpg を開く(読む前に1500px以内に縮小)
  3. perception.json — 完全な知覚データ(閾値で隠された低信頼度イベントもここに含まれる)

⚠️ 鉄則(2026-07-05 Leo QAで決定)

  • トランスクリプトは最初から最後まで読まなければ正確なレポートは作成できない(2026-07-16 Leoがサンプリング読みで出典を誤り、さらに動画全体で最も面白い3つの詳細を見逃した事例あり):transcript.txt 全文を読んでから内容の分解を書くこと。サンプリングは秒数を確認するためだけに使い、理解の代わりにしてはいけない

  • 知覚ラベルは手がかりであって結論ではない:引用する前にフレームとトランスクリプトでクロス検証すること(MANIFESTの冒頭でもそのように指示しています);感情モデルは「普通で力強い口調」を怒りと誤読することがある——非中性の感情で信頼度 <0.75 のものは隠されており、露出されているものも検証が必要

  • 分解・リメイクの前に必ずモーションリズム表を確認(cuts/min、中央値のショット長、カメラワーク分布)、感覚に頼らない(詳細は [[reference_reel_clone_pipeline]])

  • 回答には具体的な秒数とデータを引用し、曖昧にしない

備考

  • すべてローカルで実行、ツールは何もアップロードしない;--kb <ディレクトリ> でナレッジベースに保存
  • ダウンロードした動画や抽出したフレームは読み終わったら削除する(/tmp 内)

Individual skills in this repo

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

관련 스킬