Content
46%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 highly actionable with concrete YAML and scripts, but it is severely verbose and largely duplicates the existing reference bundle files in SKILL.md itself, with broken reference links and validation checkpoints separated from the main workflow.
Suggestions
Move the bulk of the YAML examples and the API/reference tables into references/examples.md and references/reference.md, leaving SKILL.md as a concise overview with one or two quick-start templates.
Integrate a 'validate with cfn-lint / create-change-set / review / execute' feedback loop directly into the 8-step creation workflow so validation checkpoints are inline rather than isolated.
Fix the 'Related Resources' links to point to references/examples.md and references/reference.md (the actual bundle paths) and remove the duplicated in-body example sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~1947-line body is noticeably verbose, explaining concepts Claude already knows (template section purposes, pseudo parameters, IMDSv2) and duplicating large YAML blocks that already live in references/examples.md and references/reference.md. | 2 / 5 |
Actionability | Provides concrete, mostly executable CloudFormation YAML and complete bash scripts (cfn-lint, drift detection, change-set review), but many resource snippets reference undefined parameters (!Ref AmiId, SubnetId) leaving minor gaps. | 4 / 5 |
Workflow Clarity | An 8-step creation sequence is listed, but validation checkpoints are not integrated into that flow — they live in a separate 'Best Practices' section; for a destructive/batch deployment operation the missing inline checkpoints cap this at 3. | 3 / 5 |
Progressive Disclosure | Although real bundle files exist and are signaled, the SKILL.md body inlines ~1900 lines of examples and reference material that clearly belong in those separate files, and the 'Related Resources' links point to broken root paths (EXAMPLES.md / REFERENCE.md) instead of references/. | 2 / 5 |
Total | 11 / 20 Passed |