Content
92%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: concrete commands and verbatim prompt material, a sequenced workflow with real validation and cost-governance checkpoints, and clean deferral of deep detail to a single well-signaled reference. The only blemish is inline volatile facts (prices, current adapter lock) that belong in the dated reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no explanations of what music generation or ffprobe are, and every section is directive. It falls short of the 5 anchor because time-sensitive details ("currently $0.04/request", "$0.08/request", adapter "currently ... locked to `lyria-3-pro-preview`", current resolver precedence) are stated inline rather than confined to the dated reference, and a few checklist lines restate earlier sections. It is clearly above the 3 anchor, which requires unnecessary explanation or notable slack. | 4 / 5 |
Actionability | Fully executable guidance throughout: a copy-paste `ffprobe` command with exact flags and JSON output, a verbatim instrumental-only constraint block, a fully specified 9-point prompt structure with ordering, concrete vocal/lyric contracts with section labels, and specific auth error codes (`403`, `API_KEY_SERVICE_BLOCKED`) with an explicit credential-precedence rule. The 4 anchor's 'minor gaps' fit worse than the 5 anchor's copy-paste-ready coverage of the common cases (underscore, full song, vocals). | 5 / 5 |
Workflow Clarity | The 8-step Required Workflow is clearly sequenced with explicit validation checkpoints ("Probe the actual file and listen before recording duration, format, or approval metadata"), feedback loops for error recovery (retry treated as a billable regeneration; "Do not spend retries on permission failures. Resolve the credential/project path first"), and a closing Quality Checklist. This matches the 5 anchor's validation + feedback-loop + checklist profile; the destructive/batch cap does not apply since probing and auditioning are mandated. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview that defers API shape, pricing detail, and prompt templates to a single one-level-deep reference, clearly signaled with when-to-read conditions ("Read [references/api-and-prompting.md](references/api-and-prompting.md) when choosing a model, designing vocals or custom lyrics, using image inputs, debugging the response, or checking current limits and pricing"). The reference file exists, is well-organized, and contains no nested .md references (only external links), matching the 5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |