Content
93%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 reference-style skill body: dense with verified, non-obvious corrections, fully actionable identifiers and examples, and clean routing to a well-organized bundle. The only gap is that multi-step workflow validation lives entirely in the reference files rather than being summarized in the body, which costs it slightly on workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a terse catalog of facts Claude cannot reliably recall from pre-training ('Instance profiles: waiter + `time.sleep(10)` pattern', 'Managed policy max versions: 5') with zero padding or explanation of known IAM concepts, and exactly one JSON example where the detail is required. Every line carries a non-obvious verified fact, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | It provides a complete, copy-paste-ready JSON policy demonstrating the ForAllValues + Null pattern, an exact CLI command ('aws organizations list-available-policy-types'), exact exception and method names ('DuplicatePolicyAttachmentException', 'activate()'), and concrete fixes ('use ForAnyValue:StringEqualsIgnoreCase', 'Scope Resource to specific role ARNs or an IAM path'). The guidance is fully executable across the common cases. | 5 / 5 |
Workflow Clarity | Routing conditions are unambiguous ('Read [references/aws-iam-role-management.md] if the user needs to create, scope, or maintain IAM roles', a MUST directive for policy generation) and a global verification checkpoint is mandated ('verify specific claims... against official AWS documentation rather than relying on pre-training'). However, the body contains no explicit validation feedback loops or step sequences for the workflows it routes to — those live in the reference files — so it fits 'clear sequence with most checkpoints present; minor validation gaps' rather than anchor 5. | 4 / 5 |
Progressive Disclosure | The body (~92 lines) keeps terse high-value corrections inline by design and defers deeper patterns to real, one-level-deep reference files ('See [references/common-pitfalls.md]'), each signaled with explicit read conditions. All referenced paths resolve to actual files in the bundle, and cross-links between references are lateral with no nesting chains, giving easy navigation and an appropriately split structure. | 5 / 5 |
Total | 19 / 20 Passed |