← Back to Skills Marketplace
itzsubhadip

YouTube Transcript (yt-dlp captions)

by Subhadip Sarkar · GitHub ↗ · v1.0.5
linuxdarwinwin32 ⚠ suspicious
2119
Downloads
0
Stars
10
Active Installs
6
Versions
Install in OpenClaw
/install youtube-transcript-yt-dlp
Description
Extract YouTube video transcripts from existing captions (manual or auto-generated) using yt-dlp, with optional timestamps and local SQLite caching. Use when...
Usage Guidance
This skill appears to do what it claims: extract YouTube captions using yt-dlp and an optional YouTube transcript-panel fallback. Before installing, ensure you have yt-dlp on PATH and understand that the script will contact YouTube (network access) and write a local cache (default {baseDir}/cache/transcripts.sqlite or ~/.config/yt-transcript/). If you need authenticated access on restricted IPs, provide a cookies.txt file in Netscape format and keep it outside the skill folder (e.g., ~/.config/yt-transcript/) because cookies are secrets and can be mispublished. Finally, review and approve running subprocesses (yt-dlp) in your environment since the script invokes yt-dlp and performs HTTP requests to YouTube.
Capability Analysis
Type: OpenClaw Skill Name: youtube-transcript-yt-dlp Version: 1.0.5 The skill bundle is suspicious due to the presence of fully implemented, but currently unused, functions (`_thirdparty_tubetranscript`, `_thirdparty_downsub`, `_thirdparty_noteey` in `scripts/yt_transcript.py`) designed to send YouTube video IDs to third-party transcript providers (yt-to-text.com, downsub.com, noteey.com). This directly contradicts explicit statements in `SKILL.md` that the published version 'does not call third-party transcript providers' and 'does not send video IDs/URLs to third-party transcript providers'. While these functions are not actively called in the current execution flow, their presence represents a latent capability for data exfiltration and a significant discrepancy between stated policy and code capabilities, raising trust concerns. The code otherwise implements good security practices like input validation and path allowlisting for cookies and cache.
Capability Assessment
Purpose & Capability
Name/description (YouTube transcript via yt-dlp) matches the actual requirements and behavior: the skill requires python3 and yt-dlp, validates inputs as YouTube URLs/IDs, prefers manual captions then auto captions, and caches results. No unrelated binaries, env vars, or credentials are requested.
Instruction Scope
SKILL.md instructions stay within scope: they only instruct running the provided script, optionally supplying a cookies file or env var for authenticated YouTube access, and explicitly warn against forwarding arbitrary flags or publishing cookies. The runtime instructions and the script focus on YouTube and local caching; they do not ask to read unrelated files or send data to third-party transcript providers.
Install Mechanism
There is no install spec (instruction-only with an included script). That reduces supply-chain risk. The script relies on system yt-dlp and python3 rather than fetching arbitrary remote code during install.
Credentials
No required environment variables or credentials are declared. The only optional secret is cookies (YT_TRANSCRIPT_COOKIES), which is appropriate for accessing authenticated YouTube sessions. Cookies are handled as secrets and the code filters cookie entries to YouTube/Google domains.
Persistence & Privilege
The skill is not always-enabled (always:false) and does not declare elevated privileges. It writes a local SQLite cache and supports storing cookies under ~/.config/yt-transcript/ or {baseDir}/cache/, which is reasonable for a caching/transcript tool. Note: writing cache files into {baseDir}/cache can cause artifacts inside the skill directory if the agent's baseDir is a location that gets published—SKILL.md warns about this.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install youtube-transcript-yt-dlp
  3. After installation, invoke the skill by name or use /youtube-transcript-yt-dlp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
Metadata: make cookies env var optional (not required). Clarify cookie handling; no auto-load from skill dir.
v1.0.4
Docs/metadata: declare YT_TRANSCRIPT_COOKIES env var (optional) and remove cookie auto-load mention.
v1.0.3
Privacy: remove third-party transcript fallbacks from published skill. Security: enforce cookies/cache path allowlisting; stop auto-loading cookies from skill dir.
v1.0.2
Security: restrict --cookies/--cache paths. Add DownSub + Noteey fallbacks; reorder third-party fallbacks.
v1.0.1
Docs: clarify cookies are optional; recommend storing cookies outside skill folder to avoid accidental publishing.
v1.0.0
Initial release: captions-only transcripts via yt-dlp with caching + cookie support.
Metadata
Slug youtube-transcript-yt-dlp
Version 1.0.5
License
All-time Installs 10
Active Installs 10
Total Versions 6
Frequently Asked Questions

What is YouTube Transcript (yt-dlp captions)?

Extract YouTube video transcripts from existing captions (manual or auto-generated) using yt-dlp, with optional timestamps and local SQLite caching. Use when... It is an AI Agent Skill for Claude Code / OpenClaw, with 2119 downloads so far.

How do I install YouTube Transcript (yt-dlp captions)?

Run "/install youtube-transcript-yt-dlp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is YouTube Transcript (yt-dlp captions) free?

Yes, YouTube Transcript (yt-dlp captions) is completely free (open-source). You can download, install and use it at no cost.

Which platforms does YouTube Transcript (yt-dlp captions) support?

YouTube Transcript (yt-dlp captions) is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).

Who created YouTube Transcript (yt-dlp captions)?

It is built and maintained by Subhadip Sarkar (@itzsubhadip); the current version is v1.0.5.

💬 Comments