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: a tightly sequenced five-step workflow with explicit validation and feedback loops, a concrete worked mapping example, and a lean overview that delegates all contract detail to well-labeled one-level-deep references. The only relative weakness is that much of the core guidance is abstract policy language, which slightly limits copy-paste actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~38-line body is dense with skill-specific policy and contains no padding or explanation of concepts Claude already knows; every sentence ('Preserve existing entities, IDs, native guards and provider-managed state/defaults') carries non-obvious guidance. It assumes Claude's competence and matches 'lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | The five-step workflow gives concrete instructions ('trace the affected entities, IDs, auth, credentials, queries and workers') and the worked example uses real specifics ('GET/PATCH /projects/:projectId/notes/:noteId', 'requireOwnedProject(actor, projectId)'). However much of the body is policy-level principle ('no owner column at every step, team/role engine or mirrored billing ledger by default') rather than executable instruction, fitting 'mostly executable guidance with minor gaps' rather than fully copy-paste ready. | 4 / 5 |
Workflow Clarity | Inspect, Map, Resolve, Record and act, Verify and report form a clear sequence with an explicit feedback loop ('If a check fails, correct the bounded mapping/implementation and rerun affected checks') and validation checkpoints ('Mark these checks proposed until run', 'Report actual results or mark checks unrun'). Delayed-work authority rechecks are also explicit, matching the anchor for clear sequence with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is a concise overview pointing to 13 real one-level-deep reference files, each bullet clearly signaling its topic and usage condition ('Email unsubscribe ... only when affected') with apt deep links (e.g. background-work.md#persist-first-then-enrich-the-entity). All referenced files exist in the bundle and cross-links between them are lateral, not nested chains, matching 'clear overview with well-signaled one-level-deep references'. | 5 / 5 |
Total | 19 / 20 Passed |