Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-structured advisory skill body with executable CLI commands, clear routing, numbered workflows, checklists, and a clean one-level reference structure. The main weakness is conciseness — repeated safety refrains and an inline Critical Facts section that mirrors the reference workflows add length that could be tightened without losing value.
Suggestions
Deduplicate the 'advisory-only / never execute without explicit confirmation' refrain — it appears in the Overview, Common Tasks constraints, Critical Facts (pricing fact 7), and Security Considerations; state it once authoritatively and back-reference it from the other locations.
Tighten 'Critical Facts to Always Surface' into terse forcing-function bullets that link to the relevant reference for full detail, instead of restating the upgrade/MariaDB/pricing/Blue-Green/Proxy fact lists inline where they duplicate the workflow references.
Trim the obvious rationale in Production Instance Creation's 13 best-practice bullets (e.g., 'It's cheaper and faster than gp2 with no minimum IOPS purchase') while retaining the exact flag guidance, to reduce length without losing actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (no basic-concept explanations) and is dense with RDS-specific facts, but it restates the 'advisory-only / never execute without confirmation' refrain in the Overview, Common Tasks, Critical Facts, and Security sections, and the long inline 'Critical Facts to Always Surface' duplicates content already in the reference workflows. Fits 'mostly efficient but could be tightened' rather than 'every token earns its place'. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands — the complete `aws rds create-db-instance` block with all production flags, `describe-db-engine-versions --query ...`, and the exact script invocation `rds_commitment_pricing_analyzer.py --instance-type db.r7g.2xlarge --engine mysql --num-instances 2`, plus specific parameters such as `require_secure_transport=ON` and `binlog_format=ROW`. Matches the score-3 anchor; not score 2 (no pseudocode or missing key details). | 3 / 3 |
Workflow Clarity | Clear routing via the Decision Guide table and a numbered Common Tasks sequence (Verify Dependencies → Classify and Route → Execute), with workflows exposing `## Tasks` steps, pre/post checklists, and explicit confirmation gates for destructive ops ('MUST pause and ask the user for explicit confirmation before presenting the switchover-blue-green-deployment command'). Validation and feedback loops are present, so the destructive-ops cap does not apply. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview that points via a Decision Guide table to one-level-deep references (upgrade-workflow.md, commitment-pricing-workflow.md, proxy-advisor-workflow.md, bluegreen-advisor-workflow.md, verify-dependencies.md); all referenced files exist and the engine-specific sub-references they delegate to are leaf content with no further indirection. Well-signaled navigation and an appropriate content split match the score-3 anchor. | 3 / 3 |
Total | 11 / 12 Passed |