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 SKILL.md body: dense, command-first, with explicit validation checkpoints before destructive operations and a clean one-level-deep reference structure covering the whole domain. The only deductions are minor — an inline CLI version number and deliberate repetition of the hotswap/express production warning.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — terse tables, error→fix rows, and command snippets with no concept explanations — but the inline version pin "CLI ≥ 2.1120.0" is time-sensitive information outside a deprecated/old-patterns section, and the hotswap/express production prohibition is repeated across Critical Warnings, Common Workflows, the Fast Deployments section, and three troubleshooting rows. These minor instances could be trimmed, matching anchor 4 rather than the lean-everywhere anchor 5. | 4 / 5 |
Actionability | Nearly every entry is a copy-paste-ready command or code snippet — "cdk bootstrap aws://$ACCOUNT/$REGION", "cdk rollback $STACK --orphan <LogicalId>", "CrossStackReferences.of($RESOURCE).produce(ReferenceStrength.BOTH)", "Aspects.of(app).add(new AwsSolutionsChecks())", "rm -rf cdk.out" with "--output ./cdk.out.$BUILD_ID" for CI — and the 16-row troubleshooting table covers the common failure cases with specific fixes. | 5 / 5 |
Workflow Clarity | Sequences are explicit with validation checkpoints for destructive operations: "cdk synth --strict → cdk diff → cdk deploy" with "Always diff before deploy to production", "cdk drift $STACK (use --fail in CI)", and the deadly-embrace fix spelled out as a three-deploy weakening sequence. Error-recovery feedback loops (rollback via "cdk rollback", roll-forward for failed --express, "--revert-drift") are present throughout the troubleshooting table. | 5 / 5 |
Progressive Disclosure | The ~80-line body is a true overview: each section (warnings, workflows, troubleshooting, construct patterns) links to a well-signaled, one-level-deep reference file, and all 10 linked files exist in references/ and map cleanly to sections with no inlined content that belongs elsewhere and no nested references. | 5 / 5 |
Total | 19 / 20 Passed |