Content
100%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.
An exemplary instruction-only skill body: lean, fully actionable, with explicit routing, validation checkpoints, error-stop policy, and safe guards around deletion. Bundle structure matches every referenced path and flag, and progressive disclosure is clean at exactly one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~50 lines of dense operational rules — selection preferences, routing, one command, output and deletion policy — with no concept explanations and no padding. Every sentence instructs rather than explains, matching the 'lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | The cleanup command is concrete and executable ('node "<skill-dir>/scripts/strip-transcript.mjs" "<subtitle-file>" > "<run-dir>/transcript.txt"') with explained flags whose behavior was verified against the actual script, and routing conditions are specific and testable. Placeholders are explicitly defined ('Use its absolute path as <run-dir>'), so the guidance is copy-paste ready rather than pseudocode. | 5 / 5 |
Workflow Clarity | The sequence is explicit with branching (URL returns subtitles → clean; returns media → go directly to recognition) and includes validation checkpoints: 'Check command errors and confirm this run produced a transcript containing text. Report empty results rather than claiming success', plus a stop-and-report error policy. Because validation precedes the destructive cleanup-deletion step and playlist/batch handling is addressed, the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview that routes to one-level-deep, well-signaled references ([URL transcripts](references/url.md), [Local transcripts](references/local.md#speech-recognition)) that exist on disk with matching headings, plus a bundled script. Content is appropriately split with nothing inlined that belongs in a reference. | 5 / 5 |
Total | 20 / 20 Passed |