youtube-transcript

Files (2)

• SKILL.md
• fetch_transcript.sh · scripts/

SKILL.md (first lines)

# YouTube Transcript

YouTube動画の字幕を取得し、**要約＋詳細解説＋整形済み全文トランスクリプト**を1つのMarkdownファイルに書き出す。

## 前提

- `uv`/`uvx` および `python3` が利用可能であること（`yt-dlp` は `uvx` が都度取得する）。
- ネットワーク接続が必要。
- **供給網ハードニング**: `yt-dlp` は**バージョン固定**で実行する（`uvx yt-dlp@<固定版>`）。
  未固定だとPyPIの最新へ浮動し、悪性リリースをレビュー猶予なく実行しうるため。
  更新はスクリプト内 `YTDLP_VERSION` を意図的に引き上げて行う（環境変数で一時上書きも可）。
- スクリプトは**絶対パスで直接実行**する（`cd` を含む compound command は使わない）。
  スクリプト本体: `${CLAUDE_PLUGIN_ROOT}/skills/youtube-transcript/scripts/fetch_transcript.sh`
  （プラグインのインストール先により実体パスは異なる。実行時はそのフルパスを使う）

## Step 1: 入力の解釈

`$ARGUMENTS` を受け取り、空白で分割して解釈する。

- 先頭の `http`/`https` で始まるトークン → **YouTube URL**
- 2つ目のトークンがあれば → **出力先パス**（ディレクトリ or ファイルパス）
- **URLが無い場合**: `AskUserQuestion` でYouTube URLを尋ねる
- **出力先が無い場合**: `AskUserQuestion` で保存先を尋ねる
  - 選択肢例: 「llm-wiki/inbox に保存」「カレントディレクトリに保存」「パスを直接指定」
  - 「llm-wiki/inbox」が選ばれた場合の実パスは環境依存。`/llm-wiki` スキルが管理する Vault の
    `llm-wiki/inbox` を使う（パスをハードコードせず、ユーザーの環境に合わせて解決する）。

## Step 2: 字幕・メタ情報の取得

一時作業ディレクトリは**プロジェクト内の `.tmp/yt-transcript`**（`/tmp` は使わない）。

スクリプトを絶対パスで実行する:

```bash
/絶対パス/scripts/fetch_transcript.sh "<URL>" ".tmp/yt-transcript"
```

stdout にKEY=VALUE形式のマニフェストが出力される。`STATUS` を確認する:

- `STATUS=OK`: `TITLE` `UPLOADER` `DURATION` `UPLOAD_DATE` `URL` `SUB_LANG` `WORDS` `CHARS` `TRANSCRIPT_FILE` を取得。
  `TRANSCRIPT_FILE` のパスを `Read` で読み込み、整形済みトランスクリプト本文を得る。
  （`WORDS` は空白区切り語数で日本語では実質無意味。日本語字幕では `CHARS`（文字数）を報告に使う）
- `STATUS=NO_SUBTITLES`: 字幕が存在しない。ユーザーにその旨を伝えて終了（無理に本文生成しない）。
- `STATUS=ERROR`: `ERROR_MESSAGE` を提示して終了。

> 補足: スクリプトは「日本語 → 英語 → 動画の原語 → 任意の手動字幕」の順で字幕を探す。
> `SUB_LANG` が `en` 等の場合、トランスクリプト全文は原語のまま。要約・解説は日本語で書く。

## Step 3: Markdownファイルの生成

`Read` した整形済みトランスクリプトを**一次情報**として、以下の構成でMarkdownを組み立てる。
要約・解説は**日本語**で書く（トランスクリプト本文は原語のまま掲載）。

````markdown
# <動画タイトル> 文字起こしと解説

- **動画**: <URL>
- **投稿者/チャンネル**: <UPLOADER>
- **尺**: <DURATION>
- **公開日**: <UPLOAD_DATE を YYYY-MM-DD に整形>
- **字幕言語**: <SUB_LANG>（ja=日本語 / en=英語 など。自動字幕の場合はその旨注記）
- **取得日**: <`date +%Y-%m-%d` で取得した現在日付>

> 本ドキュメントは公式/投稿者の字幕(yt-dlpで取得)を一次情報として要約・整理したもの。
> 自動字幕の場合は聞き起こし誤りを含む可能性があるため、重要箇所は原典で確認すること。

---

## TL;DR（要約）

<動画全体の要点を箇条書き3〜6点で。>

## 詳細解説

<トランスクリプトを章立てして解説。トピックごとに見出しを立て、
重要な用語・主張・手順・コード・数値を漏らさずまとめる。
話者が複数いる場合は役割や発言の対応も補足する。>

## 補足・参考（任意：Web検索で補強した場合のみ掲載）

<トランスクリプトに無い背景・用語定義・関連リンクを箇条書き。各項目に出典URLを付ける。
 字幕本文には無い外部情報であることが分かるように書く。補強しなかった場合はこのセクションごと省く。>

## 全文トランスクリプト

<Readした整形済み全文をそのまま掲載。話者交代マーカー「›」は維持する。
 ※全文は字幕の一次情報。Web検索で得た情報をここに混ぜない。>
````

### 内容生成の指針

- **要約**: 動画のジャンルを問わず要点を端的に。技術動画ならAPI/手順/数値、対談なら主張/結論。
- **詳細解説**: トランスクリプトの流れに沿って章立て。長い動画でも省略せずカバーする。
  コード・コマンド・固有名詞は正確に。字幕由来で不確かな箇所は「（字幕の聞き起こし、要確認）」と明記。
- **全文**: 整形済みトランスクリプトを改変せず掲載（要約・解説の根拠として残す）。

### Web検索による補強（必要時のみ）

トランスクリプトは**一次情報**。要約・解説はまずトランスクリプトだけで組み立てる。
その上で、以下に当てはまる場合に限り `WebSearch`（必要なら `WebFetch`）で補う。

- **不確かな固有名詞・専門用語・製品名・数値の確認**: 自動字幕の聞き起こし誤りが疑われる箇所を正しい表記・定義に裏取りする。
- **前提知識の補足**: 動画が背景知識を前提にしていて、要約・解説の理解に文脈追加が有益なとき。
- **言及された外部リソースの特定**: 動画内で触れられたツール・論文・URL等の正式名称や所在を特定するとき。

補強時の原則:

- **トランスクリプト優先**: 検索結果がトランスクリプトと矛盾する場合は、トランスクリプトを一次情報として扱い、相違点を注記する（字幕誤りの可能性も併記）。
- **出所を明示**: 外部情報は本文中で「（補足: …）」のように区別し、`## 補足・参考` セクションに**出典URL付き**でまとめる。
- **全文は不可侵**: `## 全文トランスクリプト` には外部情報を混ぜない。
- **過剰検索をしない**: トランスクリプトだけで十分自己完結する動画では検索しない。補強は質の向上に寄与する範囲にとどめる。

## Step 4: ファイル書き出し

- **ファイル名**: 動画タイトルから生成。OSで使えない文字 `/ \ : * ? " < > |` は全角や `-` に置換し、前後空白を除去。
  例: `<安全化したタイトル> 文字起こしと解説.md`
- **保存先**: Step 1で確定した出力先。
  - 出力先がディレクトリ → その直下に上記ファイル名で保存
  - 出力先がファイルパス（`.md`で終わる）→ そのパスに保存

From TAATHub/claude-code, MIT.

More from TAATHub/claude-code