Download YouTube subtitles (SRT + timestamped TXT) for a channel, playlist or video via yt-dlp, no media download; optionally mine them into a categorized catalog (e.g.

MITAuto-check passedMedia & Creative

Install Youtube Srt

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill youtube-srt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard youtube-srt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/video-transcription/.pi/skills/youtube-srt .claude/skills/youtube-srt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-srt
GitHub stars
315
Token cost
~1.2k tokens
SKILL.md length
497 words
Files
3 (incl. scripts)
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

Download YouTube subtitles (SRT + timestamped TXT) for a channel, playlist or video via yt-dlp, no media download; optionally mine them into a categorized catalog (e.g.

  • Works in 2 steps: fetch subtitles → model catalog (docs/models/)
  • Tasks that involve Transcription
  • SKILL.md covers Prerequisites, Stage 1 — fetch subtitles, Stage 2 — model catalog… and Pitfalls
  • Runs Python and Shell scripts from its folder; calls pipx and python3; reaches youtube.com

What it does

Youtube Srt is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Download YouTube subtitles (SRT + timestamped TXT) for a channel, playlist or video via yt-dlp, no media download; optionally mine them into a categorized catalog (e.g. AI models by function, open weights, local runnability, hardware tier). Use on "download the srt of this video", "transcripts of channel X for the last N months", "catalog the models AI Search talked about", "update docs/models".

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/build-catalog.py` and `scripts/yt-srt.sh`).

It sits in Media & Creative, covering Transcription and Video and podcast notes. It works with YouTube. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

When your agent uses it

  • Tasks that involve Transcription
  • Tasks that involve Video and podcast notes

Example prompts

  • “download the srt of this video”
  • “transcripts of channel X for the last N months”
  • “catalog the models AI Search talked about”
  • “/youtube-srt”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. fetch subtitles
  2. model catalog (docs/models/)

What it can do on your machine

Read from SKILL.md and the folder at commit 7a2d171. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • pipx
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • youtube.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube Srt loads about 1.2k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from BlackBeltTechnology/pi-agent-dashboard at commit 7a2d171, republished under its MIT licence (© BlackBeltTechnology). 497 words, ~1,178 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-srt/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
youtube-srt
description
Download YouTube subtitles (SRT + timestamped TXT) for a channel, playlist or video via yt-dlp, no media download; optionally mine them into a categorized catalog (e.g. AI models by function, open weights, local runnability, hardware tier). Use on "download the srt of this video", "transcripts of channel X for the last N months", "catalog the models AI Search talked about", "update docs/models".

YouTube SRT → catalog

Two stages. Stage 1 is generic (any channel/video). Stage 2 is the model-catalog pipeline that produced docs/models/ from @theAIsearch.

Prerequisites

  • yt-dlp on PATH (pipx install yt-dlp; if pipx complains about uv: pipx install --backend pip yt-dlp).
  • python3 (stdlib only) for stage 2. No API keys — YouTube captions are free.

Stage 1 — fetch subtitles

bash
S=packages/video-transcription/.pi/skills/youtube-srt/scripts
$S/yt-srt.sh -s now-6months "https://www.youtube.com/@theAIsearch"      # channel, date window
$S/yt-srt.sh "https://www.youtube.com/watch?v=VIDEO_ID"                   # single video
$S/yt-srt.sh -o ~/somewhere -l "de.*,de" -n 50 "https://youtube.com/playlist?list=..."
FlagMeaningDefault
-o DIRoutput dir~/Documents/Media/youtube/<@handle> (or misc)
-s SINCElower upload-date bound (YYYYMMDD, now-6months, today-30days) — stops at first older videonone
-l LANGSyt-dlp --sub-langsen.*,en
-n MAXmax playlist items scanned200

Output per video: <YYYYMMDD>_<id>_<title>.<lang>.srt + .txt ([mm:ss] line, rolling auto-caption duplicates removed, ~4× smaller — feed THIS to LLMs). index.tsv = id, date, duration, url, title. Manual subs preferred, auto-captions fallback; when both en-orig and en exist only en-orig is kept.

Idempotent: .archive.txt skips fetched IDs; IDs whose subtitles failed (HTTP 429) are removed from the archive and the script prints WARN: N video(s) without subtitles → just rerun later.

Stage 2 — model catalog (docs/models/)

  1. Fetch: $S/yt-srt.sh -s <window> "https://www.youtube.com/@theAIsearch".
  2. Batch: in <out>/extract/, ls ../*.txt | sort | split -l 6 -a 1 - batch- (~6 videos ≈ 60k tokens per batch; for an incremental update list only the new .txt files and pick unused batch letters).
  3. Extract: one general-purpose subagent per batch (host cap ≈ 2 concurrent), prompt: Working dir: <out>. Read extract/PROMPT.md and follow it exactly. Batch file extract/batch-X; write extract/X.jsonl. PROMPT.md holds the schema below; copy it from an existing <out>/extract/PROMPT.md or recreate from this section.
  4. Render: python3 $S/build-catalog.py <out>/extract docs/models → README.md, one <category>.md per function, local-hardware.md (tiers T0–T5), models.jsonl (merged, one model per line). Hand-curated picks.md is never touched by the renderer — refresh it via DocScribe when data changes.
Show full SKILL.md (217 more words)Show less
Extraction schema (one JSON object per model per video)

model, family, vendor, category, functions[], open_weights, license, local_runnable, params, size_gb, hardware, tooling, access, strengths, weaknesses, benchmarks, video_id, video_date, timestamp

category ∈ llm coding multimodal-omni image-gen image-edit video-gen video-edit music tts-voice asr-speech realtime-voice 3d world-model avatar-lipsync agent robotics science-medical embedding-other. Null when the video doesn't say — never invent numbers. Skip sponsor segments.

Merge + tier rules (build-catalog.py)
  • Same model across videos = same normalized model string; latest non-null fact wins; category = most frequent; every mention kept as a timestamped source link.
  • Hardware tier (local models only): explicit GB → tier; else presenter wording (per ;-clause strongest requirement, cheapest clause wins); else checkpoint size as est. T0 phone/CPU · T1 ≤8 GB · T2 ≤16 GB · T3 ≤32 GB · T4 ≤128 GB workstation · T5 multi-GPU.

Pitfalls

  • HTTP 429 from YouTube on bulk runs: built-in --sleep-subtitles 2; rerun to fill gaps.
  • --break-on-reject makes yt-dlp exit non-zero on a date-bounded run — expected, ignored.
  • Auto-captions mishear names ("clawed" = Claude, "Quen" = Qwen); extraction prompt tells the agent to correct obvious ones; residual oddities stay as heard.
  • Names that differ between videos ("Qwen 3.6" vs "Qwen3.6 35B-A3B") stay separate rows — normalization is deliberately conservative.
  • Specs are the presenter's claims, unverified. The catalog says so; keep that caveat.
  • Keep raw transcripts outside the repo; the catalog cites YouTube URLs with &t= only.

© BlackBeltTechnology, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in packages/video-transcription/.pi/skills/youtube-srt of BlackBeltTechnology/pi-agent-dashboard.

  • SKILL.md
  • scripts/build-catalog.py
  • scripts/yt-srt.sh

Open the folder on GitHubat commit 7a2d171

Compare with similar skills

Youtube Srt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube Srt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Srt this skillBlackBeltTechnology/pi-agent-dashboard315—~1.2kAutomated safety check: PassMIT
Youtube TranscriptCommandCodeAI/agent-skills1331 repos~3.4kAutomated safety check: NotesMIT
Omk YoutubeKaimingWan/oh-my-kiro107—~381Automated safety check: PassMIT
Youtube Batch Transcript Extractor API Skillbrowser-act/skills6.1k1 repos~1.4kAutomated safety check: PassMIT
Extract Transcriptpamelafox/presentation-skills125—~287Automated safety check: PassMIT
Youtube CLIItamarZand88/CLI-Anything-WEB231—~764Automated safety check: PassMIT

Similar skills

  • Youtube Transcript

    CommandCodeAI/agent-skills

    Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube.

    133 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check: notes
  • Omk Youtube

    KaimingWan/oh-my-kiro

    Extract and summarize YouTube video content via subtitle extraction.

    107 GitHub stars~381 tokensUpdated 6 mo ago
    Media & CreativeAuto-check passed
  • This skill helps users automatically extract YouTube video transcripts and metadata in batch via the BrowserAct API.

    6.1k GitHub starsUsed in 1 repo~1.4k tokens
    Media & CreativeAuto-check passed
  • Extract Transcript

    pamelafox/presentation-skills

    Extract a timestamped transcript from a YouTube video. An agent skill from pamelafox/presentation-skills.

    125 GitHub stars~287 tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Youtube CLI

    ItamarZand88/CLI-Anything-WEB

    Searches YouTube and fetches video transcripts via the cli-web-youtube command-line tool — video search, video details (views, duration, description, keywords), trending by category, channel info…

    231 GitHub stars~764 tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • Gemini Yt Video Transcript

    sundial-org/awesome-openclaw-skills

    Create a verbatim transcript for a YouTube URL using Google Gemini (speaker labels, paragraph breaks; no time codes).

    663 GitHub stars~293 tokensUpdated 7 mo ago
    Media & CreativeAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 70 skills in this repo
  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    316 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    316 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    316 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Questions about Youtube Srt

What does Youtube Srt do?

Download YouTube subtitles (SRT + timestamped TXT) for a channel, playlist or video via yt-dlp, no media download; optionally mine them into a categorized catalog (e.g. Youtube Srt is an agent skill from BlackBeltTechnology/pi-agent-dashboard.g.

When should I use Youtube Srt?

Youtube Srt fits situations like: tasks that involve Transcription; tasks that involve Video and podcast notes.

How do I install Youtube Srt in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill youtube-srt -a claude-code`. Or copy the skill folder (packages/video-transcription/.pi/skills/youtube-srt in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/youtube-srt in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Srt in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill youtube-srt -a codex`. Or copy the skill folder (packages/video-transcription/.pi/skills/youtube-srt in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/youtube-srt in your project. Codex loads it when a task matches its description.

Can I use Youtube Srt in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill youtube-srt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-srt, .gemini/skills/youtube-srt, .github/skills/youtube-srt and .opencode/skills/youtube-srt in your project.

What does Youtube Srt need to run?

Going by SKILL.md and its folder, Youtube Srt needs Python and a shell for the scripts in its folder and the command-line tools its instructions call (pipx and python3). Our summary lists: Python 3; A Bash shell.

Does Youtube Srt access the network?

SKILL.md names 1 domain. In commands or code: youtube.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Youtube Srt safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Youtube Srt use?

Youtube Srt is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube Srt use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Youtube Srt?

Skills that share tags, products or a category with Youtube Srt: Youtube Transcript (CommandCodeAI/agent-skills, 133 stars), Omk Youtube (KaimingWan/oh-my-kiro, 107 stars), Youtube Batch Transcript Extractor API Skill (browser-act/skills, 6.1k stars) and Extract Transcript (pamelafox/presentation-skills, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Srt?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 10, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.