Content
68%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-structured, mostly actionable CDK skill body with concrete guidance and a working example. Its main weakness is the absence of validation checkpoints in the deployment workflow, which caps workflow clarity, and the example has a small import gap.
Suggestions
Add an explicit validation checkpoint to the Instructions workflow, e.g. 'Run cdk diff before every deploy and review resource replacements' as a numbered step.
Fix the TypeScript example by importing the cdk module (import * as cdk from "aws-cdk-lib";) so the code is copy-paste executable.
Drop or trim the 'You are an expert in AWS CDK...' opener, which restates the skill's purpose already covered by the frontmatter description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with well-organized sections and no padding explaining what CDK is; the only trimmable bit is the 'You are an expert...' opener, fitting 'efficient; minor instances of over-explanation'. | 4 / 5 |
Actionability | Concrete directives (L2 over L1, least privilege, RemovalPolicy/Tags) and a near-complete TypeScript example provide mostly executable guidance, with a minor gap — the example uses cdk.RemovalPolicy without importing the cdk module. | 4 / 5 |
Workflow Clarity | The six-step Instructions list gives a usable sequence, but it has no validation checkpoints (e.g. cdk diff before deploy) for destructive infrastructure changes, so workflow_clarity is capped at 3 per the destructive-operation rule. | 3 / 5 |
Progressive Disclosure | No bundle files exist and the body is organized into clear headed sections (Use/Don't use, Instructions, Examples, Best Practices, Troubleshooting), giving good structure with minor organization gaps rather than the fully split, referenced layout at 5. | 4 / 5 |
Total | 15 / 20 Passed |