Content
50%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 content is highly actionable, with copy-paste-ready code and concrete configuration values across RDS Proxy, Data API, Serverless v2, and Prisma, but it is a monolithic 645-line document that pads with material Claude already knows and duplicates across sections. Risky database workflows (migrations, cluster deletion) also lack the validation checkpoints the domain demands.
Suggestions
Split language-specific guides (Python/boto3, Prisma, CLI quick reference) into reference files under references/ and keep SKILL.md as a lean overview with the strategy table, key settings, and anti-patterns.
Remove the opening Aurora definition, the generic Prisma schema example, and the duplicated IAM signer code (keep it only in Security), cutting the body to a fraction of its size.
Add validation checkpoints to risky workflows: verify migrations with a smoke-query after 'prisma migrate deploy', and warn before 'delete-db-cluster --skip-final-snapshot' (confirm a recent snapshot exists first).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~645-line body pads sections Claude doesn't need: an opening definition of what Aurora is ("Amazon Aurora is a MySQL/PostgreSQL-compatible relational database..."), a 30-line generic Prisma User/Post schema, IAM signer code duplicated in both the RDS Proxy and Security sections, and full parallel CRUD-plus-transaction treatments of the Data API in both TypeScript and Python. This matches anchor 2's 'noticeably verbose; several unnecessary explanations or padded sections' — the volume is well past what a lean SKILL.md should inline, even though much of the code itself is domain-specific and useful. | 2 / 5 |
Actionability | Guidance is overwhelmingly concrete and executable: copy-paste CDK for the proxy and cluster, a working pg Pool with IAM auth, boto3 rds-data helpers, Prisma migration commands, exact CloudWatch metric names, and specific proxy settings (MaxConnectionsPercent: 90, borrowTimeout 30s). It misses a 5 due to minor gaps: the well-known Prisma-on-Lambda binary/packaging gotchas are unaddressed, and the code comments reference 'Data API Client v2' while installing the older 'data-api-client' package. | 4 / 5 |
Workflow Clarity | Connection-strategy selection is clearly sequenced (Strategy 1/2/3 with best-for guidance) and the scale-to-zero section includes a genuine retry/backoff feedback loop, but workflows around risky database operations lack validation checkpoints: migrations run with no post-deploy verification, and destructive commands like 'aws rds delete-db-cluster ... --skip-final-snapshot' are presented without warnings or snapshot checks. Per the rubric's database-operations note, missing feedback loops caps this at 3. | 3 / 5 |
Progressive Disclosure | The body is well-sectioned with clear headers and an upfront Sources link list, but no bundle files exist and everything — the Python guide, the Prisma setup, the CLI quick reference, the PgBouncer config — is inlined in one 645-line file. This matches anchor 3: some structure, but content that clearly belongs in separate reference files is inline. | 3 / 5 |
Total | 12 / 20 Passed |