CtrlK
BlogDocsLog inGet started
Tessl Logo

youtube-downloader

Download YouTube videos and HLS streams (m3u8) from platforms like Mux, Vimeo, etc. using yt-dlp and ffmpeg. Use this skill when users request downloading videos, extracting audio, handling protected streams with authentication headers, or troubleshooting download issues like nsig extraction failures, 403 errors, or cookie extraction problems.

70

Quality

86%

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

81%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 highly actionable, well-sequenced operational skill with real validation checkpoints, error-recovery loops, and a properly wired bundle (real, one-level-deep references and a documented script). Its main weakness is token efficiency: the internal SOP and checklist sections duplicate content available in references/ and each other, and the HLS block is inline bulk that should be split out.

Suggestions

Replace the inlined 'Reliable Download SOP (Internal)' section with a pointer to references/internal-sop.md (both files carry nearly identical step lists), keeping only any steps not already in the reference.

Consolidate the 'Agent Execution Checklist' with the 'Troubleshooting Quick Reference' section — both cover the same failures (not-a-bot, only-images, PO token provider, proxy) from slightly different angles, which costs tokens and risks divergent guidance.

Move the detailed HLS/m3u8 download guide (steps, header patterns, separate-stream merging, troubleshooting) into a reference file such as references/hls-streams.md, leaving a short summary and link in SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly dense with genuinely non-obvious operational knowledge (PO token providers, format IDs 137/271/313, nsig failures, client quirks), but it inlines a 'Reliable Download SOP (Internal)' section that near-verbatim duplicates references/internal-sop.md, the 'Agent Execution Checklist' repeats the Troubleshooting section's cause/solution pairs, and well-known ffmpeg flags (libx264, crf ranges) are explained. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 2 anchor's several padded sections, and the duplication is more than the 4 anchor's minor trims.

3 / 5

Actionability

Nearly all guidance is copy-paste executable: complete yt-dlp and ffmpeg commands with format strings and header patterns, a full argument reference for scripts/download_video.py, and concrete verification commands (yt-dlp -F, ffprobe). The only placeholder (<YTDLP_PYTHON>) is explicitly resolved in-line by instruction, so this matches the fully executable anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Workflow Clarity

Workflows are clearly sequenced (default user flow 1-5, SOP steps 1-8 with fallback branches like Docker bgutil to browser WPC, HLS steps 1-3) and include explicit validation checkpoints (re-run yt-dlp -F and look for formats 137/271/313, ffprobe resolution check, --info metadata confirmation), retry feedback loops in every troubleshooting entry, and a dedicated checklist. This matches the anchor requiring validation steps, error-recovery loops, and checklists rather than the 4 anchor's 'minor validation gaps'.

5 / 5

Progressive Disclosure

The bundle is well-structured: references/po-token-setup.md and references/internal-sop.md exist, are one level deep, and are clearly signaled with purpose statements ('Read it first when a download fails for no obvious reason'), and the script is documented with its full argument list. However, the SOP content that lives in references/internal-sop.md is duplicated inline in the body, and the ~130-line HLS section is bulk content that belongs in a reference file, which are the 'minor organization gaps' of the 4 anchor rather than the clean split of a 5.

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 strong description: concrete capabilities, named tools and platforms, and an explicit 'Use this skill when...' clause covering download, audio-extraction, protected-stream, and troubleshooting triggers. The only gap is a handful of natural synonyms (e.g., MP3, save/rip video) in the trigger vocabulary.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ("Download YouTube videos and HLS streams (m3u8)", "extracting audio", "handling protected streams with authentication headers", troubleshooting "nsig extraction failures, 403 errors, or cookie extraction problems") with named tools (yt-dlp, ffmpeg). It matches the anchor for multiple specific concrete actions with comprehensive coverage; a 4 would require minor gaps in coverage, which are not evident here.

5 / 5

Completeness

It clearly answers both what ("Download YouTube videos and HLS streams (m3u8)... using yt-dlp and ffmpeg") and when ("Use this skill when users request downloading videos, extracting audio, handling protected streams... or troubleshooting download issues...") with concrete trigger phrases. This matches the anchor-5 example structure exactly; a 4 would require the 'when' clause to be less explicit or specific.

5 / 5

Trigger Term Quality

Natural phrases like "downloading videos", "extracting audio", "403 errors", and "m3u8" are present, giving good keyword coverage. A few natural terms users would say are missing (e.g., "save video", "rip", "MP3", "convert to MP4"), so it falls just short of the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (yt-dlp/ffmpeg-based video and HLS stream downloading, including named platforms Mux and Vimeo) with distinct trigger terms (nsig extraction, m3u8, PO-token-era failure modes). Conflict risk with other skills is minimal; a 4 would require noticeable overlap with closely related skills, which is not the case.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (510 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
daymade/claude-code-skills
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.