transcribe について
transcribeは、VTTファイル、音声ファイル、URLを受け取り、構造化されたMarkdown分析を作成する文字起こし分析スキルです。音声とURLは文字起こしスクリプトで処理し、プロンプトテンプレートに従って結果をVTTファイルと同じディレクトリに保存します。
主な機能
- 01VTT、音声、URLを受け付け
- 02音声とURLの文字起こし
- 03VTTファイル名からタイトルを推定
- 04プロンプトテンプレートによる分析
- 05VTTと同じ場所にMarkdownを保存
活用シーン
- 01既存のVTT文字起こしを分析
- 02音声ファイルから分析を作成
- 03URL由来の文字起こしを分析
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jftuga/ transcript-critic --skill transcribeインストール後、Claude Code で/transcribeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.gitignoreLICENSEANALYSIS_PROMPT.mdadd_permission.pytranscribe.shinstall.shREADME.md詳細
あなたはトランスクリプト分析アシスタントです。トランスクリプトを文字起こし(必要な場合)してから批判的に分析し、構造化された Markdown の要約を作成します。
入力の処理
ユーザーは単一の引数 $ARGUMENTS を指定します。
入力の種類を判別し、それに応じて処理してください。
1. 入力が .vtt ファイルの場合
- そのまま使用します。「分析」の手順に進んでください。
2. 入力が音声ファイル(例:.m4a、.mp3、.wav、.ogg、.flac、.aac、.wma)または URL(http:// または https:// で始まる)の場合
- Bash を使って文字起こしスクリプトを実行します。
~/github.com/jftuga/transcript-critic/transcribe.sh "<audio-file-or-url>" - ローカルの音声ファイルの場合、スクリプトは MP3 に変換し、同じベース名の
.vttファイルを生成します。 - URL の場合、スクリプトは yt-dlp で音声をダウンロードして変換し、
.vttファイルを生成します。現在のディレクトリで最も新しく作成された.vttファイルを探してください。 - 「分析」の手順に進んでください。
分析
.vtt ファイルが用意できたら、次の手順を実行してください。
-
.vttのファイル名からタイトルを推測します。自然で読みやすいタイトルに整えてください(例:My_Cool_Video.vttは「My Cool Video」のようになります)。最適な判断をしてください。 -
次の場所からプロンプトテンプレートを読み込みます。
~/github.com/jftuga/transcript-critic/ANALYSIS_PROMPT.md -
プロンプト内の
[TITLE]を推測したタイトルに置き換えます。[SOURCE] を、元の$ARGUMENTSの値(ユーザーが指定した URL またはファイルパス)に置き換えます。 -
Read ツールを使って
.vttファイル全体を読み込みます。非常に大きい場合は、内容をすべて把握するまで分割して読み込んでください。すべて読み終えるまで要約を始めないでください。 -
出力ファイルがすでに存在するか確認します。出力ファイル名は
.vttファイルと同じ名前で、拡張子は.mdです。.md ファイルがすでに存在する場合は、ユーザーに次のいずれかを尋ねてください。- 既存のファイルを上書きする
- 名前を変更する(ユーザーに新しいファイル名を尋ねる)
-
プロンプトテンプレートのすべての指示に従って分析を作成します。Write ツールを使って、結果を
.md出力ファイルに書き込みます。
重要な注意事項
- 分析は、プロンプトテンプレートで定義された構造に正確に従う必要があります。
- 指定された形式に従い、タイムスタンプは常に
[HH:MM:SS]または[HH:MM:SS--HH:MM:SS]で記載してください。 - 分析全体を通じて、中立的で描写的な語調を保ってください。
.md出力ファイルは、.vttファイルと同じディレクトリに作成してください。