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 hub-style SKILL.md: a lean body that assumes competence, routes each user need to a specific, verified reference file, and pushes all detail (and version-sensitive values) into a well-organized one-level-deep bundle. The only structural observation is mild redundancy between the Routing and Files tables, but they serve complementary purposes (when to read vs. what's inside) and cost only a few lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~37-line body is pure routing and navigation: no explanation of what Lambda or serverless is, no filler, and every row earns its tokens. The staleness caveat ("confirm values against current AWS documentation") is two lines and handles time-sensitive content by directing verification rather than embedding version numbers. | 5 / 5 |
Actionability | Every routing row names a real file and what it contains ("Read troubleshooting.md — starts with the 5 most common fixes"; "Use powertools-handler.py as a template" — a real, complete executable template), and the rows cover the common cases (build, debug, optimize, event sources, orchestration, concurrency, API Gateway, anti-patterns). Per the rubric's code-vs-instruction note, absence of inline code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | This is a single-action routing skill and the single action (match user need → read the named reference) is unambiguous; the 'Spans multiple areas' row even handles the ambiguous case ('read the most specific reference first, then consult others'). No destructive or batch operations appear, so the validation cap does not apply, and the simple-skill exception yields 5. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all 9 referenced .md files and the asset exist and match their described contents; references are exactly one level deep (spot-checks show reference files link only to external AWS docs, never to each other or to third-level files); the Routing and Files tables make navigation trivial. | 5 / 5 |
Total | 20 / 20 Passed |