CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

youtube-transcript

Fetches a YouTube video's transcript as plain text (optional [mm:ss] timestamps) with a stdlib-only Python script that works from cloud IPs where yt-dlp and youtube-transcript-api are blocked. Use before summarising or quoting a video; triggers on a youtube.com / youtu.be link plus "transcript", "summarise this video", or "/youtube-transcript".

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary lean skill page: exact executable commands with flag and output contracts, a verbatim-exit-message-driven failure table with retry policies and fallbacks, and background rationale correctly offloaded to a single well-signaled reference. Every line is operational and verifiable against the bundled script. No weaknesses found.

DimensionReasoningScore

Conciseness

The body is lean and operational throughout: "Gets a YouTube video's captions as text in one command", the exact invocation, flag semantics, and a dense failure table. Explanatory rationale is deferred to references/why-innertube.md rather than inlined, and nothing teaches concepts Claude already knows, matching anchor 5's 'every token earns its place'. Not anchor 4: there is no over-explanation left to trim — even the asr caveat ("auto-captions mishear names and jargon") is operationally necessary for quoting accuracy.

5 / 5

Actionability

Fully executable guidance: `python3 -I <skill_dir>/scripts/yt_transcript.py "<url-or-id>" > transcript.txt` with `--lang <code>` and `--timestamps` documented, an explicit stdout/stderr contract ("stderr carries `# <title> [<lang>, <manual|asr>]`; stdout carries only the transcript"), a concrete right/wrong example with a real video ID, and error handling keyed to the script's verbatim exit messages (verified against scripts/yt_transcript.py). This matches anchor 5's copy-paste-ready coverage of common cases.

5 / 5

Workflow Clarity

The three-step procedure (run, read transcript.txt, caveat asr quotes) is unambiguous, and the "When it fails" table supplies explicit feedback loops: "Wait a minute and retry once", "Bump clientVersion ... then retry once", and a terminal fallback with three concrete alternatives. The operation is neither destructive nor batch, so no cap applies; the single action is unambiguous with explicit error recovery, matching anchor 5.

5 / 5

Progressive Disclosure

One clearly signaled one-level-deep reference — "Why the script takes this route, and what fails instead: references/why-innertube.md" (verified as a real, self-contained file with no nested references) — plus one script. The split is exactly right: operational content inline, background in the reference, in a well-organized under-50-line body, matching anchor 5 per the rubric's simple-skill note.

5 / 5

Total

20

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete third-person statement of what the skill does, the environment it is designed for, and an explicit trigger clause with natural phrases. The what/when pairing is complete and the niche is clearly distinguishable. Minor gap: trigger synonyms such as "captions", "subtitles", and the US spelling "summarize" would improve coverage.

DimensionReasoningScore

Specificity

Phrases like "Fetches a YouTube video's transcript as plain text", "optional [mm:ss] timestamps", "stdlib-only Python script", and "works from cloud IPs where yt-dlp and youtube-transcript-api are blocked" state several concrete capabilities, matching anchor 4. It stays at 4 rather than 5 because it describes one core action with modifiers rather than multiple distinct concrete actions (e.g., language selection or title retrieval are not mentioned).

4 / 5

Completeness

It explicitly answers both: what — "Fetches a YouTube video's transcript as plain text (optional [mm:ss] timestamps) with a stdlib-only Python script" — and when — "Use before summarising or quoting a video; triggers on a youtube.com / youtu.be link plus 'transcript', 'summarise this video', or '/youtube-transcript'". This matches anchor 5's pattern of concrete trigger phrases attached to an explicit when clause, well above anchor 4's softer 'when'.

5 / 5

Trigger Term Quality

"triggers on a youtube.com / youtu.be link plus 'transcript', 'summarise this video', or '/youtube-transcript'" gives good natural keyword coverage including URL forms, matching anchor 4. It falls short of anchor 5's comprehensive synonym coverage because it omits natural variants like "captions", "subtitles", and the US spelling "summarize".

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (YouTube transcripts) with distinct triggers combining a YouTube link with the word "transcript", giving minimal conflict risk as in anchor 5. The only adjacency is "summarise this video" overlapping generic summarization skills, but the YouTube-link constraint keeps it distinct — not enough to drop to anchor 4's 'minor overlap risk'.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

mthines/agent-skills

Path

skills/analysis/youtube-transcript/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.