CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dsql

Deprecated compatibility redirect for Aurora DSQL guidance. Use when a request concerns DSQL, Aurora DSQL, distributed SQL, DSQL schemas, migrations, queries, authentication, performance, or application development.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

An exemplary redirect skill body: lean, unambiguous, and immediately actionable, with exact install commands and sensible guardrails (do not combine guidance, get approval before installing). The only visible gaps are the absence of a failure-path recovery step and the deferral of Codex/Cursor install commands to an external link.

Suggestions

Add one recovery step for the failure path, e.g., 'If the marketplace add or install command fails, report the error and link the user to the awslabs/agent-plugins installation instructions rather than retrying blindly.'

Inline the one-line Codex/Cursor install commands (or note that they change and must be read from the linked instructions) so the skill remains actionable without a fetch for the most common clients.

DimensionReasoningScore

Conciseness

Opens with 'This standalone skill is deprecated' and every subsequent line is load-bearing: the canonical path, a non-combination rule, the advisory-reading clarification, and exact install commands. No padding or explanation of concepts Claude already knows, matching the lean anchor at 5 rather than the minor-trim anchor at 4.

5 / 5

Actionability

Provides a concrete decision workflow and copy-paste Claude Code commands ('/plugin marketplace add awslabs/agent-plugins', '/plugin install databases-on-aws@agent-plugins-for-aws'). Minor gap: Codex and Cursor users get only a link to current instructions rather than inline commands, so it falls short of the fully-executable anchor at 5.

4 / 5

Workflow Clarity

A clear numbered sequence with a decision branch (canonical skill available → follow it; unavailable → explain the move) and an approval gate ('Get explicit user approval before installing anything'). No error-recovery guidance for the failure path (e.g., what to do if the marketplace add fails), which keeps it below the feedback-loop anchor at 5; there are no destructive or batch operations, so the cap of 3 does not apply.

4 / 5

Progressive Disclosure

The body is under 50 lines, needs no external reference files, and is organized into clear sections (redirect path, redirect rules, install commands). Per the simple-skill guideline this earns a 5 with just well-organized sections; there are no nested or buried references.

5 / 5

Total

18

/

20

Passed

Description

78%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.

A well-formed description for a redirect skill: it clearly states what it is (a deprecated compatibility redirect) and when to use it, with a strong natural-keyword trigger list anchored on the distinctive 'DSQL'/'Aurora DSQL' niche. Its only weaknesses are that the capability statement is thin (a single action) and a few broad trigger words could overlap with general database skills.

Suggestions

If more capability detail is warranted, state the redirect action concretely (e.g., 'Redirects DSQL requests to the canonical databases-on-aws dsql skill in awslabs/agent-plugins') instead of relying on the trigger list alone.

Tighten the broadest trigger words ('queries', 'performance', 'application development') toward DSQL-qualified forms (e.g., 'DSQL query performance') to reduce overlap with generic SQL/database skills.

DimensionReasoningScore

Specificity

Names the domain ('Aurora DSQL guidance') and one concrete action ('compatibility redirect'), but the remainder of the sentence is a trigger list rather than additional capabilities. Fits the anchor 'names domain and 1-2 concrete actions, but not comprehensive'; it does not list several specific actions, ruling out 4.

3 / 5

Completeness

Explicitly answers what ('Deprecated compatibility redirect for Aurora DSQL guidance') and when ('Use when a request concerns DSQL, Aurora DSQL, ...') with concrete trigger phrases, matching the anchor-5 example pattern. The explicit 'Use when...' clause rules out the cap of 3 and the vaguer anchors below.

5 / 5

Trigger Term Quality

'DSQL, Aurora DSQL, distributed SQL, DSQL schemas, migrations, queries, authentication, performance' provides good keyword coverage of natural user phrasing. A few natural variations (e.g., 'DSQL database', 'Amazon Aurora') are missing, so it falls short of the comprehensive-synonym anchor at 5.

4 / 5

Distinctiveness Conflict Risk

'DSQL' and 'Aurora DSQL' carve out a clear niche with distinct triggers, but the generic terms 'queries, authentication, performance, application development' create minor overlap risk with general database/SQL skills. Fits 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor at 5.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

awslabs/mcp

Path

src/aurora-dsql-mcp-server/skills/dsql-skill/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.