Content
67%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.
A well-structured, genuinely actionable skill body with strong safety gating, real executable commands, and a clean routing layer over a verified reference bundle. Its main cost is token efficiency: a large duplicated fact section (written explicitly to satisfy a grading rubric) and time-pinned version examples inflate the body at the expense of the otherwise excellent progressive-disclosure design.
Suggestions
Delete the "Rubric-Critical Facts to Always Surface" section from the body and move the five scenario checklists into their matching reference files (troubleshooting.md, compute-runtime.md, cman-proxy.md), keeping only one-line routing pointers — the facts currently appear twice in the bundle.
Remove rubric-gaming meta-commentary ("the rubric greps for these", "a common misdiagnosis that the rubric catches", "Agents without this skill get this wrong") and replace the version-pinned examples (claude-sonnet-4-20250514, 19.0.0.0.ru-2024-01) with placeholders or move them to a versioned reference so they don't age.
Close the remaining workflow gap by adding an explicit failure branch after the connectivity diagnostics (e.g. "if test_connectivity.sh fails DNS → check VPC DNS resolution; if TCP fails → check SG/NACL/routes") and a re-prompt loop for parameter validation instead of only listing formats.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — the routing table, safety tiers, and troubleshooting table are dense with non-obvious RDS-specific facts Claude would not reliably know ("RDS Oracle is VPC-only", "no SYS/SYSTEM logins", NAE/return-path NACL rules) — but the ~60-line "Rubric-Critical Facts to Always Surface" section duplicates content already in troubleshooting.md, compute-runtime.md, and cman-proxy.md (e.g. the DPI-1047 thin-mode fix and the ORA-12170 checklist appear in both places), and meta-commentary like "the rubric greps for these" and "a common misdiagnosis that the rubric catches" earns no tokens for the reader. Version-pinned examples ("claude-sonnet-4-20250514", "19.0.0.0.ru-2024-01") are time-sensitive and not placed in a deprecated/old-patterns section. Not 4: the duplication and rubric-gaming filler are more than "minor instances of over-explanation"; not 2 because nothing explains concepts Claude already knows and the core reference-routing content is tight. | 3 / 5 |
Actionability | Concrete, executable commands appear throughout: `aws ec2 authorize-security-group-ingress --group-id sg-123 --protocol tcp --port 1521 --source-group sg-456`, `nc -zv <rds-endpoint> 1521`, `aws rds describe-db-instances --query 'DBInstances[0].Endpoint'`, `SELECT value FROM v$parameter WHERE name = 'service_names'`, plus five bundled diagnostic scripts. Not 5: the body itself contains no complete copy-paste connection-code example (deferred to the language references, which is acceptable per the code-vs-instruction note but leaves minor gaps), and some directives like "Name 'eksctl', 'OIDC', 'iamserviceaccount' explicitly" tell the agent what to mention rather than giving the runnable command. | 4 / 5 |
Workflow Clarity | A clear three-stage sequence (Verify Dependencies → Classify and Route → Execute Workflow) with genuine validation checkpoints for the destructive operations the skill guards: explicit user-confirmation gates before any create/modify, downtime warnings before instance-class/engine changes, a refuse-and-offer-assessment path for deletes/reboots, and a dependency check that must precede code generation. The troubleshooting table gives error→fix feedback loops. Not 5: some checkpoints are implicit rather than looped — e.g. after running test_connectivity.sh there is no explicit "if this fails, go here" branch in the body, and parameter validation states formats but no re-prompt loop. | 4 / 5 |
Progressive Disclosure | Good structure: the body routes to twelve real one-level-deep reference files via a symptom→file table (all verified to exist and be substantive), instructs "Load only the matching reference", and lists the five scripts with links. Not 5: the inlined "Rubric-Critical Facts" section is exactly the detailed per-scenario content that belongs in troubleshooting.md/compute-runtime.md/cman-proxy.md (anchor-3 symptom present), and the handoff section reaches two levels deep into another skill's tree (`aws-database-selection/references/handoff-contract.md` → `workload-primary-artifact.schema.json`). These are minor organization gaps rather than structural ones, so it sits at 4. | 4 / 5 |
Total | 15 / 20 Passed |