Content
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a massive wall of inline scripts with poor organization and incomplete implementations. While some CIS and PCI-DSS checks contain real, executable AWS CLI commands, the overall skill suffers from extreme verbosity, missing workflow guidance, incomplete framework coverage (SOC 2 has zero implementation), and stub functions that add no value. The content would benefit enormously from being split into separate files per framework with a concise overview in SKILL.md.
Suggestions
Extract each framework's scripts (CIS, PCI-DSS, HIPAA) into separate bundle files (e.g., cis-checks.sh, pci-checker.py) and reference them from a concise SKILL.md overview
Add a clear workflow section with prerequisites (required IAM permissions, credential report generation), execution order, and validation steps for interpreting and acting on results
Remove the framework sub-category listings (Claude knows what PCI-DSS covers), the generic best practices, and the stub functions that return empty lists
Either implement SOC 2 checks or remove it from the supported frameworks list, and complete the placeholder comments in PCI-DSS (Requirements 2, 4)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~400+ lines. Lists every compliance framework's sub-categories (which Claude already knows), includes massive bash scripts that are largely repetitive, explains what PCI-DSS and HIPAA stand for, and includes boilerplate sections like 'When to Use', 'Example Prompts', and 'Best Practices' with generic advice. The compliance-report.py has stub functions (run_cis_checks returning empty lists) adding no value. | 1 / 3 |
Actionability | The CIS bash scripts and PCI-DSS Python checker contain real, executable AWS CLI commands and boto3 code that could be run. However, the compliance-report.py is incomplete with empty stub functions, SOC 2 has no implementation at all despite being listed, and several PCI-DSS requirements are left as comments ('Check for default passwords, etc.'). The scripts are partially actionable but incomplete. | 2 / 3 |
Workflow Clarity | There is no clear workflow for how to actually use these scripts together. No sequencing of steps, no validation checkpoints, no guidance on prerequisites (e.g., IAM permissions needed, credential report generation), no error handling guidance, and no feedback loops. The scripts are presented as standalone fragments without integration into a coherent compliance-checking workflow. | 1 / 3 |
Progressive Disclosure | All content is dumped into a single monolithic file with hundreds of lines of inline bash and Python scripts. There are no bundle files to offload the individual framework scripts to. The 'Additional Resources' section links to external sites but doesn't organize the skill's own content. Each framework's checks should be in separate referenced files. | 1 / 3 |
Total | 5 / 12 Passed |