From 899394074c53b49987688987da31fd9a7841d1f7 Mon Sep 17 00:00:00 2001
From: Yuval Adam <_@yuv.al>
Date: Wed, 18 Mar 2026 15:47:15 +0100
Subject: Add youtube-transcript

---
 youtube-transcript/SKILL.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 youtube-transcript/SKILL.md

(limited to 'youtube-transcript/SKILL.md')

diff --git a/youtube-transcript/SKILL.md b/youtube-transcript/SKILL.md
new file mode 100644
index 0000000..e8625ef
--- /dev/null
+++ b/youtube-transcript/SKILL.md
@@ -0,0 +1,32 @@
+---
+name: youtube-transcript
+description: Fetch and save YouTube video transcripts as clean plain text. Use when the user provides a YouTube URL or wants to extract a transcript from a podcast, interview, or talk.
+---
+
+# YouTube Transcript
+
+Extracts clean, deduplicated plain-text transcripts from YouTube videos using `yt-dlp`.
+
+## Dependencies
+
+- `yt-dlp` (must be installed and on PATH)
+- Python 3.10+
+
+## Usage
+
+Fetch a transcript and save it to a file:
+
+```bash
+python3 .pi/skills/youtube-transcript/yt_transcript.py "YOUTUBE_URL" -o transcript.txt
+```
+
+Options:
+- `-l LANG` — subtitle language code (default: `en`)
+- `-o FILE` — output file path (default: stdout)
+
+## Workflow
+
+When the user gives a YouTube URL:
+
+1. **Fetch transcript** — Run the script, optionally with `-o <path>` to save to a file.
+2. **Review** — Read through the transcript and summarise the key points if the user asks.
-- 
cgit v1.3.1