Content
86%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.
A well-engineered routing-style SKILL.md: lean body, fully executable CLI examples, a decision guide that reliably lands the reader on the right one-level-deep reference, and strong gotcha coverage via critical rules and a troubleshooting table. The main gaps are mild token duplication between the Usage section and the frontmatter description, and validation checkpoints that are implied rather than explicitly stated in the body's workflows.
Suggestions
Remove or drastically shorten the 'Usage' bullet list — it duplicates the frontmatter trigger list almost verbatim and adds ~9 lines of tokens with no new information.
Add explicit verification checkpoints to the in-body workflows (e.g., after a Cost Explorer query, confirm results are non-empty and date ranges are current before drawing conclusions), rather than relying on the troubleshooting table for error recovery after the fact.
Move the Billing Views 'API support for --billing-view-arn' table and one of the two billing-view CLI examples into a reference file (e.g., a billing-views.md), keeping one example plus the discovery command inline to reduce body tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and earns its tokens: executable commands, a decision-guide table, a troubleshooting table, and two high-value critical rules with no padding or basic-concept tutorials. Minor trims exist — the 'Usage' bullet list largely duplicates the frontmatter triggers, and the Billing Views API-support table plus multiple billing-view examples are detail that could live in a reference file. Not 5 because of that duplication; not 3 because there is no over-explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Fully executable copy-paste AWS CLI commands with complete flags and JSON ('aws ce get-cost-and-usage --time-period ... --group-by Type=DIMENSION,Key=SERVICE', the create-budget JSON), exact enrollment command, concrete gotchas ('Price List API service codes differ from Cost Explorer service names'), and an error/cause/fix troubleshooting table covering the common failure cases. Not 4 because the guidance goes beyond examples to concrete behavioral rules (filter JSON, exclusive end dates, region requirements). | 5 / 5 |
Workflow Clarity | The decision guide and the enumerated 7-step cost audit ('top cost drivers → month-over-month comparison → ... → report') give a clear sequence, and the two critical rules act as pre-flight checkpoints (check current date before API calls; always script numerical calculations). The troubleshooting table provides error-recovery mapping, but the body's workflows lack explicit inline validation checkpoints where intermediate results are verified before proceeding. Not 5 because checkpoints are implied (via references) rather than stated as explicit verify-then-proceed steps in the body; not 3 because sequencing is clear and error recovery is well covered. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview/routing document: a decision table maps each user question to a tool and a single reference file, all 16 bundle files in references/ are one level deep, every referenced path exists, and every file on disk is referenced from the body (no orphans, no missing). Deep material (per-service optimization, audit workflow, calculation patterns) is correctly split out with clearly signaled 'Read references/...' pointers. Not 4 because there are no organization gaps — navigation is trivial and nothing that belongs in a reference is monolithically inlined. | 5 / 5 |
Total | 18 / 20 Passed |