CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-aurora

AWS Aurora Serverless v2, RDS Proxy, Data API, connection pooling

48

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/aws-aurora/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Weight 40%Scale 1-5

Reviews 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).

DimensionReasoningScore

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

Description

56%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a precise keyword list for a well-defined AWS Aurora niche, but it describes topics rather than actions and omits any 'Use when' trigger guidance from the description field itself. It reads more like a tag list than a capability statement, leaving both 'what it does' and 'when to use it' under-specified.

Suggestions

Rewrite the description with verb-led, third-person capability statements, e.g., 'Configures Aurora Serverless v2 clusters, sets up RDS Proxy and Data API connections for Lambda, and implements connection pooling.'

Append an explicit trigger clause to the description: 'Use when working with Aurora, RDS, serverless Postgres/MySQL databases, or database connection pooling in AWS.'

Add natural synonyms users would say (RDS, Aurora PostgreSQL, serverless database, failover) to improve trigger term coverage.

DimensionReasoningScore

Specificity

The description lists four concrete technologies ("AWS Aurora Serverless v2, RDS Proxy, Data API, connection pooling") but contains no actions at all — it is a topic keyword list, not a statement of capabilities. It sits below anchor 3, which requires 1-2 concrete actions (e.g., 'Configures', 'Sets up'), and fits anchor 2's 'names the domain but actions are minimal or generic' with actions entirely absent.

2 / 5

Completeness

The 'what' is only weakly implied by the topic list (no verbs describe what the skill does), and the description itself contains no 'Use when...' clause — the trigger guidance lives in a separate when-to-use field outside the evaluated text. Per the rubric guideline, a missing explicit trigger clause caps completeness at 3; it does not fall to 2 because the technologies named do convey a recognizable 'what'.

3 / 5

Trigger Term Quality

Terms like "AWS Aurora", "Serverless v2", "RDS Proxy", "Data API", and "connection pooling" are exactly what a user needing this skill would naturally say, giving good keyword coverage. It falls short of anchor 5 because common synonyms and variations (RDS, Aurora PostgreSQL/MySQL, 'serverless database', 'failover') are missing.

4 / 5

Distinctiveness Conflict Risk

"AWS Aurora Serverless v2, RDS Proxy, Data API" carves out a clear, AWS-specific niche with minimal conflict risk against unrelated skills. It is not a 5 because the generic "connection pooling" term and absence of trigger phrasing create minor overlap risk with general database/Postgres skills.

4 / 5

Total

13

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (645 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

alinaqi/maggy

Path

skills/aws-aurora/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.