Content
88%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 strong instruction-only skill body: it provides exhaustive, executable tool routing, parameter, and error-handling detail with explicit validation and retry loops, and it assumes Claude's intelligence rather than teaching background concepts. The main deductions are mild redundancy between Step 2/4 and the Common Mistakes table, and a monolithic single-file structure that inlines a full API reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and tool-specific throughout — parameter enums, defaults, limits, and error codes Claude cannot know — with no space wasted explaining what fonts or MCP tools are. However, there is measurable redundancy: the identifier rules of Step 2 are restated in the Common Mistakes table, the Error Handling table overlaps the per-tool error descriptions in Step 4, and the Surface-note blockquote plus per-tool fallback notes repeat the same two widget caveats. That is 'minor instances of over-explanation that could be trimmed' (level 4) rather than level 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Every section gives executable, tool-specific guidance: exact parameter lists with types, enums, and defaults ('per_page (1–100, default 10)', 'writing_systems (comma-separated ISO 15924 codes, default "latn")'), a literal init payload, concrete presentation rules ('Use the exact detail_url field, or omit the link'), and specific error codes with the action for each. It matches level 5 ('copy-paste ready... specific examples cover the common cases') for an instruction-only skill per the scoring notes, and exceeds level 4, which tolerates 'minor gaps'. | 5 / 5 |
Workflow Clarity | The workflow is a clearly sequenced Step 0–4 with explicit feedback loops and validation checkpoints: 'Validate before calling — clamp per_page to ≤100 and shorten user_query', 'Split into smaller batches rather than retrying the same oversized one', 'Re-check the script code / parameters and try once more; if still empty, say so plainly', and case-sensitivity warnings with a concrete example ('"myriadpro-regular" will not resolve "MyriadPro-Regular"'). The Error Handling and Common Mistakes tables complete the fix-and-retry loop. This matches the level-5 anchor (explicit validation steps, error-recovery feedback loops, checklist) rather than level 4, which allows 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | The body has a clean top-level structure (Tool Reference, Workflow with per-tool subsections, Error Handling, Common Mistakes) with no nested references and no bundle files to misroute — navigation is easy and every heading is load-bearing. It sits at level 4 ('good structure... minor organization gaps') rather than 5 because the ~237-line body inlines the full per-tool API and response-shape reference that, in a bundled skill, would typically be split into one-level-deep reference files; anchor 3 would apply if the inlining made the document hard to navigate, which it does not. | 4 / 5 |
Total | 18 / 20 Passed |