Content
31%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 body is a persona resume — long enumerations of known tools and vague behavioral guidance with no executable instruction, no validation checkpoints, and a broken reference to a missing playbook. It tells Claude what kind of expert to be rather than what to do.
Suggestions
Replace the capability/tool enumerations with a concise overview and move the detailed platform/technology matrices into real reference files (e.g. references/platforms.md, references/security.md).
Add concrete, executable guidance: example Terraform/Flyway snippets, backup/restore commands, failover runbook steps — not just "Apply relevant best practices".
Fix or remove the broken `resources/implementation-playbook.md` reference (the file does not exist), and add explicit validation checkpoints (validate schema migration, test backup restore, verify failover) to the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body restates the same cloud-database/automation/reliability persona across redundant sections (Purpose, Capabilities, Behavioral Traits, Knowledge Base) and enumerates tool inventories (RDS, Aurora, DynamoDB, Terraform, Flyway) Claude already knows, making it noticeably verbose and padded though not a single-concept explainer. | 2 / 5 |
Actionability | The Instructions ("Clarify goals", "Apply relevant best practices and validate outcomes") and the 9-step Response Approach are high-level hints with no concrete commands, code, or specific procedures, matching the minimal-concrete-guidance anchor. | 2 / 5 |
Workflow Clarity | The Response Approach lists a sequenced lifecycle, but database admin involves destructive/batch operations (migrations, failover, backups) with no validation checkpoints or feedback loops, so the missing-validation cap holds it at 3. | 3 / 5 |
Progressive Disclosure | 60+ lines of capability enumerations that belong in separate reference files are inlined into SKILL.md, and the one external reference (`resources/implementation-playbook.md`, line 24) does not exist on disk — a broken, minimal-structure case. | 2 / 5 |
Total | 9 / 20 Passed |