Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable executor skill with clear workflows, validation checkpoints, and clean progressive disclosure into verified bundle files. The main weakness is conciseness — the body is long and several MUST/NEVER lists and critical-facts sections overlap material that already lives in the references.
Suggestions
Trim the 'Critical Facts to Always Surface' MUST-list-all-N-facts blocks, or move them into the matching reference files and keep only a one-line pointer plus the fact count in SKILL.md, to reduce overlap with references.
Collapse the repeated MUST/NEVER constraint phrasing in 'Common Tasks → Execute the Workflow' into a single compact constraint block; the same rules are restated across several sections.
Move the full 'Resource tagging' worked example into references/connection.md and keep only the --tags syntax template in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes competence (exact CLI commands, no 'what is a database' filler), but at ~214 lines it is padded — the repeated 'MUST tell the user ALL of the following N facts' lists and restated MUST/NEVER constraints overlap with the bundled references and could be tightened. | 2 / 3 |
Actionability | Fully executable, copy-paste-ready guidance throughout — exact 'aws docdb create-db-cluster' / 'create-db-instance' commands with '--serverless-v2-scaling-configuration', DMS endpoint '--ssl-mode verify-full --certificate-arn' flags, 'db.collection.find({...}).explain()', and RDS --tags syntax. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced: a routing decision-guide table, explicit pipeline order, a numbered 'Common Tasks 1–4' flow, and validation/confirmation checkpoints for destructive ops ('MUST pause, state the consequence, and wait for explicit confirmation'). | 3 / 3 |
Progressive Disclosure | Clear overview with a well-signaled routing table pointing to one-level-deep references (connection.md, schema-advisor.md, migration.md, etc.), all of which exist, plus scripts/wa_review.py; content is appropriately split rather than nested. | 3 / 3 |
Total | 11 / 12 Passed |