SRTC — Screen Recording To Claude
SKILL_DIR はこの SKILL.md を含むディレクトリです（通常は ~/.claude/skills/srtc）。以下のコマンドはすべてそこから実行します。ツール本体は python3 "$SKILL_DIR/vtc.py"、解析エンジンは python3 "$SKILL_DIR/screencast/screencast.py" です。
機能
⌃⌘Sで画面＋マイクの録画をトグルします（メニューバーエージェントvtc-hotkey）。Escでキャンセル。10分間のキャップがあり、20秒前になるとカウントダウン音＋赤いパネルが表示されます。- 停止時：1fpsでサンプリング → 変化のない秒を削除 → 2×2のタイムスタンプ付きシート；マウスログ → 丸で囲った／静止した／クリックした箇所の拡大「ポインターシート」；Whisper（ローカル、録画中ストリーミング）→ タイムスタンプ付きトランスクリプト。
- 配信：Claudeを前面にフォーカスし、開いているチャットに画像とプロンプトを貼り付けます（ユーザーはEnterを押すだけ）。
~/.claude/CLAUDE.mdに追加されたルール（claude-rule.mdからインストール）により、ナレーションがリクエストとして扱われます。
コマンド
| 依頼 | 実行コマンド |
|---|---|
| ステータス / 録画中か確認 | python3 "$SKILL_DIR/vtc.py" status |
| 既存の録画（.mov/.mp4）を解析 | python3 "$SKILL_DIR/screencast/screencast.py" digest "<file>" → その後、出力された DIGEST.md を読み、sheets/ と pointer/ の各シートを読む |
| ストレージ使用量 | python3 "$SKILL_DIR/vtc.py" usage |
| 古い録画を削除 / すべて削除 | python3 "$SKILL_DIR/vtc.py" clean / python3 "$SKILL_DIR/vtc.py" clean --all |
| ホットキー / マイク / キャップ / 保持期間の変更 | ~/.config/vtc.json を編集（キー: hotkey, mic, cap_seconds, warn_seconds, keep_days, deliver, auto_send, asr）、その後 launchctl kickstart -k gui/$(id -u)/com.srtc.hotkey |
| インストール / 再インストール | "$SKILL_DIR/install.sh"（ユーザーが実行する必要があります：ログインエージェントとキーチェーン証明書を登録します） |
ユーザーが録画直後について質問した場合、解析フォルダは recordings/<date>.digest/ で、ビデオファイルの隣にあります（デフォルトは ~/Movies/SRTC/、または ~/.config/vtc.json の recordings キーで指定されます）。最初に DIGEST.md を読み、次にリストされたシートを読んでください。
トラブルシューティング（この順番で確認）
- ホットキーが効かない、メニューバーに "hotkey blocked: password field" と表示される → 一部のアプリがセキュアキーボード入力を保持しています（フォーカスされたパスワードフィールド、よくあるのはブラウザ）。そのフィールドからクリックで外れます。
ioreg -l -w 0 | grep -o '"kCGSSessionSecureInputPID"=[0-9]*'でPIDが表示されます。 - ホットキーが効かない、ログに "not trusted" と表示される（
~/Library/Application Support/VideoToClaude/hotkey.log）→ アクセシビリティ権限が失われています（sign.shなしで再ビルドした後に発生）。システム設定 → プライバシーとセキュリティ → アクセシビリティ：vtc-hotkeyを削除（−）し、再度追加（+ またはバイナリをドラッグ）します。エージェントは2秒以内に再起動します。 - 「何も録画されなかった」 →
vtc-hotkeyの画面収録またはマイク権限が不足しています。画面収録権限はlaunchctl kickstart -k gui/$(id -u)/com.srtc.hotkeyの後でのみ適用されます。 - トランスクリプトが空または文字化けしている → 解析結果の "audio peak / average" 行を確認してください。平均が −40 dB 未満の場合は、間違ったマイクが選択されています。
~/.config/vtc.jsonのmicは優先順位リストです。python3 "$SKILL_DIR/screencast/screencast.py" devicesでデバイス一覧を表示します。 - トランスクリプトは正常だが遅い → Whisperモデルが不足しています（
models/whisper-large-v3-turbo/weights.safetensors）。READMEを参照してください。 ログ：~/Library/Application Support/VideoToClaude/{hotkey,runner,asr,recorder-ffmpeg}.log
install.sh、sign.sh、launchctl bootstrap を自分で実行しないでください。コマンドを表示して、ユーザーに実行させてください。