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.
The body is a tight, high-signal skill: it documents non-obvious failure modes, gives a copy-paste output-contract template with clear placement and scope rules, and closes with a Non-fix section that prevents wasted effort on impossible fixes. The only weakness is minor: a version-gated behavior note ('Since omp 18.10.3') sits in the main flow rather than a deprecated/old-patterns section and could be tightened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — the Problem section documents genuinely non-obvious failure modes (the {"data": ...} envelope, MAX_YIELD_RETRIES=3, the 'result' label pitfall) rather than known concepts. Minor trimmable instances remain: the version-gated line 'Since omp 18.10.3...' is time-sensitive info outside a deprecated/old-patterns section, and the enumerated example field lists are slightly padded, fitting the score-4 anchor rather than a flawless 5. | 4 / 5 |
Actionability | The Practice section supplies a copy-paste-ready contract template ('Output contract: finish by calling yield with {"data": {...}} on success...'), specifies placement (append to the task/prompt text, not just the mechanically attached schema), frequency ('applied every time an outputSchema is supplied'), and covers the nested-array case. For an instruction-only skill this is fully executable guidance covering the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | This is a simple, single-purpose prompting habit whose single action is unambiguous, and the conditional case is explicitly handled ('apply this to task() only for agents whose frontmatter sets structured: true'). Per the simple-skill exception the single action scores 5; it involves no destructive or batch operations, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, well-organized into Problem / Practice / Non-fix sections, and needs no external references — no references/, scripts/, or assets/ bundle exists and none is required. The under-50-line simple-skill exception applies, so well-organized sections alone merit a 5. | 5 / 5 |
Total | 19 / 20 Passed |