Content
63%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.
The content is action-rich with executable AWS CLI/Python examples and a well-sequenced, validation-aware cleanup workflow. Its main weaknesses are length/redundancy and a monolithic inline structure that would benefit from splitting scripts into bundle files.
Suggestions
Move the standalone scripts (cleanup-unused-ebs.sh, cleanup-old-snapshots.sh, release-unused-eips.sh, calculate-savings.py, the Lambda) into a scripts/ directory and reference them from SKILL.md to improve progressive disclosure.
De-duplicate the volume-scan logic shared between calculate-savings.py and the Lambda handler, and reconcile the Lambda's direct-delete behavior with the documented dry-run-first workflow.
Trim overlapping sections (e.g. 'Best Practices' vs 'Safety Checklist' vs 'Risk Mitigation') to reduce token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining concepts Claude already knows and leads with code, but at ~300 lines it carries redundancy (the Lambda function duplicates the savings-calculator logic and several sections overlap), fitting 'mostly efficient but could be tightened' rather than 4. | 3 / 5 |
Actionability | Multiple concrete, mostly-executable bash/python/AWS-CLI snippets and a lifecycle-policy JSON give copy-paste-ready guidance, with only minor placeholders like 'my-bucket' keeping it from a 5. | 4 / 5 |
Workflow Clarity | A destructive/batch skill with a 4-phase workflow (Discovery, Validation, Execution, Verification), dry-run-first execution, and a safety checklist provides clear sequencing with most checkpoints present; minor gaps (the Lambda example deletes without dry-run) keep it below 5. | 4 / 5 |
Progressive Disclosure | There are no bundle files and all content is inlined with section headers; since the skill exceeds 50 lines and inlines full scripts that belong in a scripts/ directory, it fits 'some structure but content that should be separate is inline' rather than 4. | 3 / 5 |
Total | 14 / 20 Passed |