Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable CLI skill: every documented command is executable and matches the bundled vtd.js, structure is clear, and guidance like defaults and arg passthrough is exactly what an agent needs. The only real weaknesses are minor — slight repetition across example blocks and undocumented capabilities (clips, playlists) claimed by the description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-first with almost no explanation of concepts Claude already knows, though the near-identical example blocks (repeated "--url 'https://…' --output-dir ~/Downloads" lines) and the Notes section restating defaults could be trimmed slightly. This matches the efficient-with-minor-trimmable-instances anchor, not the 5 where every token is maximally earned. | 4 / 5 |
Actionability | Every example is a fully executable, copy-paste-ready command (setup via npm ci, transcript/download/audio/subs/formats invocations, format selection with "-- --format 137+140", remux, yt-dlp arg passthrough), and the commands verified against the actual vtd.js CLI. The examples cover all common cases including the transcript fallback behavior. | 5 / 5 |
Workflow Clarity | Setup → per-command usage → troubleshooting is clearly sequenced, subcommand help is pointed out, and error behavior is documented ("Empty cleaned subtitles exit with an error and remove their temporary files"), with verification commands in Troubleshooting. Minor gaps keep it below 5: the description's "clips" and "playlists" capabilities have no usage examples, and there is no guidance on choosing between transcript and subs. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and its single reference, "./scripts/vtd.js", is a real bundle file clearly signaled and central to the skill; helper scripts (html-entities.js, vtd.test.mjs) are appropriately not inlined. At ~86 lines the body exceeds the under-50-line simple-skill exemption, and the unmentioned bundle files plus some content that could live in a reference keep this at good-structure-with-minor-gaps rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |