Skip to content
AI & Agents
Skill

/video-transcript-downloader

yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.

BOOST
@steipetesteipete@steipete
From plugin
agent-scripts
7.1k54 skills
Install
$ npx -y skills add steipete/agent-scripts --skill video-transcript-downloader --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/video-transcript-downloader

Context preview

The summary Claude sees to decide when to auto-load this skill.

yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.

SKILL.md

video-transcript-downloader.SKILL.md
name: video-transcript-downloader
description: "yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists."

Video Transcript Downloader

`./scripts/vtd.js` can:

  • Print a transcript as a clean paragraph (timestamps optional).
  • Download video/audio/subtitles.

Transcript behavior:

  • YouTube: fetch via `youtube-transcript-plus` when possible.
  • Otherwise: pull subtitles via `yt-dlp`, then clean into a paragraph.

Setup

cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci

CLI syntax:

./scripts/vtd.js --help
./scripts/vtd.js transcript --help

Subcommands support focused help without requiring `--url`.

Transcript (default: clean paragraph)

./scripts/vtd.js transcript --url 'https://…'
./scripts/vtd.js transcript --url 'https://…' --lang en
./scripts/vtd.js transcript --url 'https://…' --timestamps
./scripts/vtd.js transcript --url 'https://…' --keep-brackets

Download video / audio / subtitles

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js audio --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js subs --url 'https://…' --output-dir ~/Downloads --lang en

Formats (list + choose)

List available formats (format ids, resolution, container, audio-only, etc):

./scripts/vtd.js formats --url 'https://…'

Download a specific format id (example):

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140

Prefer MP4 container without re-encoding (remux when possible):

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4

Notes

  • Default transcript output is a single paragraph. Use `--timestamps` only when asked.
  • Bracketed cues like `[Music]` are stripped by default; keep them via `--keep-brackets`.
  • Pass extra `yt-dlp` args after `--` for `transcript` fallback, `download`, `audio`, `subs`, `formats`.
./scripts/vtd.js formats --url 'https://…' -- -v

Troubleshooting (only when needed)

  • Missing `yt-dlp` / `ffmpeg`:
brew install yt-dlp ffmpeg
  • Verify:
yt-dlp --version
ffmpeg -version | head -n 1
Read more
Read it on GitHub ↗
Ships withagent-scripts

Shared agent instructions, skills, and small portable helpers for Peter's local workspaces.

Get the whole plugin
Stats
TypeScriptJavaScriptHTMLBashSwift
+7 tags
CloudflareGitHubMarkdownAnthropicOpenAIiOSBun
7,208
Stars
617
Forks
Active
Maintenance
Shell
Language
MIT
License
19h ago
Last commit
10mo ago
Created
3h ago
Added

Repo: steipete/agent-scripts

In this plugin
54 skills
See everything inside

Other skills on agent-scripts.

See all 54 skills in agent-scripts