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: compact, jargon-free of padding, with a concrete test matrix, explicit expected outcomes, a sensible escalation rule, and a crisp exit criterion. Nothing material is missing for this scope.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~20-line body is lean and assumes Claude's competence: no explanations of what auth or sessions are; every token is a test instruction ('logout invalidates the session server-side', 'tampered signature, alg:none, wrong issuer or audience'). Matches the 5 anchor ('lean and efficient; every token earns its place'); there is nothing to trim, so it is not a 4. | 5 / 5 |
Actionability | Guidance is concrete and executable despite being instruction-only (per scoring_notes, absence of code is not penalized when guidance is actionable): 'changing IDs in the URL, body, and GraphQL variables. Expect 403/404 with no data in the body', 'repeat the request at least 3 times before and after; 5xx never decides the result', 'cookie flags (HttpOnly, Secure, SameSite)'. Specific cases, methods, and expected outcomes cover the common cases — the 5 anchor. It is not a 4 because there are no minor gaps in concrete direction. | 5 / 5 |
Workflow Clarity | Setup ('two customer accounts (A and B), an admin, and a signed-out browser') followed by a clear 7-step numbered sequence, each step with expected outcomes serving as validation ('Expect 403/404 with no data in the body', the stable-probe rule with '5xx never decides the result'), plus an explicit exit criterion checklist ('The matrix of role × object × action is complete with statuses'). This is not a destructive or batch operation, so no cap applies, and the validation/explicit-exit-criteria structure fits the 5 anchor better than the 4 anchor's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and none are needed at ~20 lines. Per the judging guideline, a skill under 50 lines with no need for external references can score 5 with well-organized sections — which this has (Procedure, Rules, Exit criteria). Not a 4, since there are no organization gaps or misplaced content. | 5 / 5 |
Total | 20 / 20 Passed |