CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

baoyu-youtube-transcript

Downloads YouTube video transcripts/subtitles and cover images by URL or video ID. Supports multiple languages, translation, chapters, and speaker identification. Caches raw data for fast re-formatting. Use when user asks to "get YouTube transcript", "download subtitles", "get captions", "YouTube字幕", "YouTube封面", "视频封面", "video thumbnail", "video cover image", or provides a YouTube URL and wants the transcript/subtitle text or cover image extracted.

Quality

88%

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

82%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.

A lean, highly actionable CLI skill document: real commands with defaults, a complete options and error reference, and a well-sequenced workflow with fallback handling. Its one real defect is that the default --speakers path depends on prompts/speaker-transcript.md, which is absent from the bundle, leaving both that workflow step and one reference dangling; a minor batch-verification gap keeps workflow clarity just below the top anchor.

Suggestions

Add the missing prompts/speaker-transcript.md to the bundle (or inline its essential instructions in SKILL.md) — it is referenced by both the Workflow and Speaker Identification sections, so the recommended default run (--chapters --speakers) cannot be completed as written.

Add an explicit verification step for multi-URL runs: after the script finishes, confirm each requested video produced an output file and report any that hit Error Cases entries (e.g., 'Video unavailable') so batch failures aren't silently dropped.

Note in the Script Directory section that the other scripts/ files (shared.ts, transcript.ts, youtube.ts, etc.) are internal modules of main.ts, so a reader scanning the bundle isn't left wondering whether they are separate entry points.

DimensionReasoningScore

Conciseness

Every section carries script-specific knowledge Claude cannot infer: the options table with defaults, the output-directory tree ("transcript-raw.json # raw API snippets { text, start, duration }[]"), the zsh quoting gotcha ("Always single-quote the URL (zsh globs ? ...)"), and the error table. No background concepts are explained; matches "Lean and efficient; assumes Claude's competence; every token earns its place". Not score 4: there is no over-explanation to trim — even the sentence-splitting detail describes non-obvious output semantics.

5 / 5

Actionability

Concrete, near copy-paste commands ("${BUN_X} {baseDir}/scripts/main.ts <url> --languages zh,en,ja") with the placeholder substitution rule stated up front, plus enumerated input URL forms, env var, and error remedies. Not score 5: the Speaker Identification workflow (which the default "--chapters --speakers for the richest output" routes through) instructs a sub-agent to "Read the saved .md and {baseDir}/prompts/speaker-transcript.md", but that file does not exist in the bundle, so a documented step cannot be executed as written — a concrete "minor gap" per the anchor-4 wording.

4 / 5

Workflow Clarity

The 5-step Workflow is clearly sequenced with a pre-flight checkpoint ("No language specified → run --list first") and an error-recovery chain ("retries alternate client identities, then yt-dlp" → "try YOUTUBE_TRANSCRIPT_COOKIES_FROM_BROWSER=safari"), and Error Cases maps failures to remedies. Not score 5: inputs allow "multiple" URLs (batch) yet there is no explicit verification step that every requested video produced an output before reporting back — a minor validation gap rather than absent validation, so the score-3 cap for batch operations without any validation does not apply.

4 / 5

Progressive Disclosure

Good structure: SKILL.md is an overview of a CLI whose implementation lives in scripts/ (main.ts referenced via a Script Directory table; supporting modules correctly left unreferenced), and the speaker-identification prompt is (rightly) split out to a separate file. Not score 5: that split-out file, "{baseDir}/prompts/speaker-transcript.md", is referenced twice but missing from the bundle (no prompts/ directory exists), so one one-level-deep reference is broken; not score 3 because all other content is appropriately placed and references are clearly signaled.

4 / 5

Total

17

/

20

Passed

Description

92%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 model description: concrete capabilities stated in third person, an explicit 'Use when...' clause with nine natural trigger phrases in English and Chinese, and a clear niche boundary. The only gap is the absence of file-extension triggers (.srt/.vtt) and a few caption-related synonyms, which keeps trigger term quality just below the top anchor.

DimensionReasoningScore

Specificity

"Downloads YouTube video transcripts/subtitles and cover images by URL or video ID", "Supports multiple languages, translation, chapters, and speaker identification", and "Caches raw data for fast re-formatting" list multiple concrete actions with both input forms (URL or video ID), covering the skill's full capability set. Not score 4: coverage is comprehensive, not just "several actions with minor gaps" — the main operations (fetch transcript, fetch cover, translate, segment, cache) are all explicitly named.

5 / 5

Completeness

Explicitly answers both questions: what — "Downloads YouTube video transcripts/subtitles and cover images... Supports multiple languages, translation, chapters, and speaker identification" — and when — "Use when user asks to... or provides a YouTube URL and wants the transcript/subtitle text or cover image extracted." This matches the anchor-5 example's structure (capabilities + concrete 'Use when' trigger phrases) exactly; score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Nine natural trigger phrases — "get YouTube transcript", "download subtitles", "get captions", "video thumbnail", "video cover image", plus Chinese variants ("YouTube字幕", "YouTube封面") — give excellent synonym coverage in two languages. Not score 5: the anchor requires "including synonyms and file extensions", and no file-extension triggers (.srt, .vtt) or common variants like "closed captions"/"CC" appear; not score 3 because synonym coverage is far richer than "Works with PDF files".

4 / 5

Distinctiveness Conflict Risk

A clear YouTube-transcript niche with distinct triggers ("get YouTube transcript", "YouTube字幕"), and the boundary is explicit: it triggers only when the user "wants the transcript/subtitle text or cover image extracted", so generic "download this YouTube video" requests won't misfire. Minimal overlap risk with any other skill category; not score 4 because there is no closely related skill it could be confused with.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

JimLiu/baoyu-skills

Path

skills/baoyu-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.