Content
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides genuinely useful, executable AWS cleanup scripts and a reasonable safety framework, but it is far too verbose for a skill file. Content that should be split into separate referenced files (Lambda code, lifecycle policies, cost calculator) is all inlined, creating a monolithic document. Several sections (Example Prompts, Kiro CLI Integration, Additional Resources, Limitations boilerplate) add little actionable value and waste tokens.
Suggestions
Reduce the SKILL.md to a concise overview (~80 lines) with the cleanup targets list, one representative script example, the safety checklist, and the workflow steps—move all other scripts and code into separate bundle files (e.g., scripts/cleanup-ebs.sh, scripts/calculate-savings.py, lambda/cleanup.py)
Remove the 'Example Prompts', 'Kiro CLI Integration', 'Additional Resources', and generic 'Limitations' sections entirely—these don't help Claude execute the task
Make validation steps in the workflow concrete: add specific AWS CLI commands to verify resource dependencies (e.g., checking if a snapshot is referenced by an AMI before deletion, checking if an EIP has DNS records)
Consolidate 'Best Practices' and 'Risk Mitigation' into the Safety Checklist to eliminate redundancy
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is excessively verbose at ~250+ lines. It includes unnecessary sections like 'Example Prompts', 'Kiro CLI Integration', 'Additional Resources', 'When to Use This Skill', and 'Limitations' boilerplate that add little value. The 'Best Practices' and 'Risk Mitigation' sections overlap significantly. Claude already knows AWS CLI syntax and boto3 patterns—much of this could be condensed dramatically. | 1 / 3 |
Actionability | The skill provides fully executable bash scripts and Python code that are copy-paste ready. The AWS CLI commands are specific with proper query filters, and the Lambda function, lifecycle policy JSON, and cost calculator are all concrete and complete. | 3 / 3 |
Workflow Clarity | The 4-phase cleanup workflow is clearly sequenced and the safety checklist is good, but the validation steps within the workflow are vague ('Verify resources are truly unused', 'Check for dependencies') without concrete commands or checks. For destructive batch operations like deleting volumes and snapshots, the feedback loops are implicit rather than explicit in the scripts themselves. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with no bundle files to offload content to. The S3 lifecycle policy, Lambda function, cost calculator, multi-account scripts, and monitoring setup could all be separate referenced files. Everything is inlined in one massive document, making it hard to navigate and consuming excessive context window. | 1 / 3 |
Total | 7 / 12 Passed |