Content
96%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 skill body: lean, imperative, and grounded in a real bundle with gated pre-flight reads, explicit validation checkpoints, and a self-critique loop before emission. The only structural weakness is references to non-bundled paths (design-templates/critique/, DESIGN.md) that a reader outside the authoring platform cannot resolve.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with constraint-level specifics ("Body 14/22", "40px weight 700 letter-spacing -0.01em", "10% alpha and a 2px stroke", "flash the changed row for 1.4s") and explains nothing Claude already knows. Every section is instruction, not padding — matching the lean anchor 5 rather than the 'minor over-explanation' anchor 4. | 5 / 5 |
Actionability | Guidance is fully executable: explicit Read steps with file paths and read conditions, a concrete API contract ("POST /api/od/connectors/poll with a JSON body { project, read }"), exact timings, and reuse instructions pointing at wired hooks in assets/template.html ("tweenText() + .flash + .db-row.changed"). Per the scoring notes, an instruction-only skill is not penalized for lacking code when guidance is this actionable; it clearly exceeds the 'minor gaps' anchor 4. | 5 / 5 |
Workflow Clarity | A clear gated sequence: a 5-step numbered Pre-flight, an explicit validation checkpoint ("every P0 row must be true before you emit index.html. Quote each P0 row inline... Do not emit while any P0 is unchecked"), and a self-critique feedback loop ("If Philosophy < 4 ... iterate on type and palette before emitting"). This matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists for complex processes'; it is not anchor 4 because no validation gate is missing. | 5 / 5 |
Progressive Disclosure | The body is an overview that pushes detail into a real, verified bundle: references/layouts.md, components.md, connectors.md, checklist.md and assets/template.html all exist, are one level deep, and each Read is clearly signaled with a load condition (e.g. connectors.md "only when inputs.connector !== mock"). It falls short of anchor 5 because two referenced paths — "design-templates/critique/" and the repeated "active DESIGN.md" — are not part of this bundle, leaving slightly dangling navigation rather than fully easy navigation. | 4 / 5 |
Total | 19 / 20 Passed |