youtube-transcript
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
Install with Tessl CLI
npx tessl i github:intellectronica/agent-skills --skill youtube-transcript92
Does it follow best practices?
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the marks. It uses third person voice, provides specific capabilities, includes comprehensive trigger terms that users would naturally use, explicitly states both what it does and when to use it, and has a clear distinctive niche that won't conflict with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists specific concrete actions: 'Extract transcripts from YouTube videos' and 'Supports output with or without timestamps' - clearly describes what the skill does with multiple specific capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Extract transcripts from YouTube videos', 'output with or without timestamps') AND when ('Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'transcript', 'subtitles', 'captions', 'YouTube video', 'YouTube URL', plus specific URL patterns (youtube.com/watch?v=, youtu.be/). | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche with distinct triggers - specifically targets YouTube videos and transcript extraction, unlikely to conflict with other skills due to the specific platform (YouTube) and action (transcript extraction). | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted, concise skill that provides clear, actionable guidance for extracting YouTube transcripts. The command examples are executable and the supported formats are clearly documented. Minor weakness in the Output section which combines behavioral constraints with file handling instructions without clear sequencing.
Suggestions
Restructure the Output section to separate the behavioral constraint (never modify transcript) from the file-saving workflow steps
Consider adding a brief note about what happens when captions are unavailable (error handling guidance)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, providing only essential information without explaining what YouTube or transcripts are. Every section serves a clear purpose with no padding. | 3 / 3 |
Actionability | Provides fully executable bash commands that are copy-paste ready. Clear examples for both basic and timestamp modes, with specific URL format examples. | 3 / 3 |
Workflow Clarity | The workflow is straightforward (run script, handle output), but the Output section mixes instructions about modifying transcripts with file saving logic without clear sequencing. No validation step for checking if captions exist before processing. | 2 / 3 |
Progressive Disclosure | For a simple single-purpose skill under 50 lines, the content is well-organized with clear sections. No need for external references given the scope, and navigation is straightforward. | 3 / 3 |
Total | 11 / 12 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
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
body_steps | No step-by-step structure detected (no ordered list); consider adding a simple workflow | Warning |
Total | 13 / 16 Passed | |
- 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.