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 routing skill with actionable, well-signaled references and a clear rerouting workflow. The only weakness is the introductory paragraph, which carries restated known concepts and marketing language that slightly undermines token efficiency.
Suggestions
Trim the intro paragraph: drop 'high-performance, secure, and reliable foundation to power agentic AI and data-driven applications' and the restated fact that each database is optimized for a workload shape — Claude already knows this; keep only the service portfolio list needed for routing.
Consider removing the relational-engine enumeration in the intro ('PostgreSQL (Aurora, DSQL, RDS), MySQL (Aurora, RDS)...') since the same mapping is already authoritative in the Service reference table below.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean directive prose (rules, tables, numbered steps), but the intro paragraph restates concepts Claude already knows ('Each AWS database is optimized for a specific workload shape or data model') and includes marketing fluff ('high-performance, secure, and reliable foundation to power agentic AI and data-driven applications') that could be trimmed. Matches 'mostly efficient but includes some unnecessary explanation or could be tightened'. | 2 / 3 |
Actionability | Gives concrete executable guidance for an instruction-only routing skill: exact paths ('read references/{sub-skill-id}.md', 'Read assets/{filename}'), specific trigger phrases, a next-steps column, and explicit MCP tool names (aws___read_documentation, aws___search_documentation). No vague direction remains. | 3 / 3 |
Workflow Clarity | 'How this skill works' is a clear three-step sequence (find sub-skill → load reference if matched → answer from cards/docs otherwise) with an explicit feedback loop: 'This matching applies to every user message... re-route immediately', reinforced by Global rule 2 ('Revise when new information arrives'). Checkpoints ('STOP', 'MUST load that skill before providing operational guidance') are explicit. | 3 / 3 |
Progressive Disclosure | The body is an overview that points to one-level-deep references (references/select.md, handoff.md, report-issue.md) and on-demand knowledge cards (assets/*.md), all clearly signaled by filename in the service reference table and verified to exist. Content is appropriately split, no nested reference chains. | 3 / 3 |
Total | 11 / 12 Passed |