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.
A well-engineered router skill: an ordered operating procedure with confirmation and error-recovery checkpoints, a safety tier system with scripted refusals and alternatives, executable commands and script invocations, and clean one-level-deep progressive disclosure into per-sub-skill references that all exist. The only improvement opportunity is removing the small amount of internal duplication (reference-loading rule vs. procedure step, repeated express-first statements).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — routing logic, safety tiers, exact flags, tag syntax — with essentially no explanation of concepts Claude already knows. However, there is minor duplication that could be trimmed: Global rule 5 ("Before responding to any matched sub-skill request, you MUST read references/{id}-instructions.md") restates step 2 of the Operating procedure, and the express-first default is stated in the intro, the decision matrix, and rule 6. Fits anchor 4 (efficient, minor over-explanation to trim) rather than 5 (every token earns its place) or 3 (noticeable unnecessary explanation). | 4 / 5 |
Actionability | Guidance is fully executable within the body's scope: exact commands with resolved flags ("python3 scripts/acu_calculator.py estimate --instance <type> --cpu-p95 <val> ..."), exact CLI flags and anti-patterns ("create-db-cluster --with-express-configuration. Do NOT separately specify --engine-mode..."), copy-paste tag syntax, named IAM policy actions for AccessDenied, and scripted two-paragraph refusal templates. Matches anchor 5 (fully executable, copy-paste ready, common cases covered); anchor 4 would require missing key details, and the deliberate deferral of full create flows to the per-sub-skill instruction files is explicit and signaled, not a gap. | 5 / 5 |
Workflow Clarity | The Operating procedure gives a clear 5-step ordered sequence with edge cases (multi-sub-skill requests, no match, failures), explicit validation checkpoints (confirmation before any mutation, tiered risk briefing before high-impact changes, "show the error and suggest a fix before retrying"), and a Troubleshooting section for error recovery — a validate→fix→retry feedback loop appropriate for database operations. Matches anchor 5 rather than 4, which would have missing checkpoints for risky operations. | 5 / 5 |
Progressive Disclosure | The body is a clear router overview: a sub-skill registry table mapping intents to instruction files, with details split one level deep into 40 real reference files (all six references/{id}-instructions.md paths referenced in the body exist on disk) and three bundled scripts whose usage is given inline with deeper docs deferred to each script's --help. Navigation is easy and nothing that belongs in a reference is inlined. Matches anchor 5 (well-signaled one-level-deep references, appropriate split) rather than anchor 4, which would have organization gaps. | 5 / 5 |
Total | 19 / 20 Passed |