CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dms-schema-conversion

Handles the full DMS Schema Conversion lifecycle including creating migration projects, converting database schemas to a target engine, running compatibility assessments, navigating metadata trees, exporting converted DDL to S3, applying schema changes to a target database, and converting SQL statements between database engines. Applies when migrating database schemas between heterogeneous engines using AWS DMS Schema Conversion.

Quality

93%

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

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

A well-engineered operational skill: fully executable CLI workflows with explicit wait/validation checkpoints, strong error-recovery loops, confirmation-guarded destructive cleanup, and a clean one-level-deep reference structure. The main weakness is token duplication — the waiter/polling boilerplate recurs across five sections despite already living in schema-conversion-operations.md.

DimensionReasoningScore

Conciseness

The body is dense with domain-specific commands and constraints and avoids explaining concepts Claude already knows, but the waiter plus fallback-polling pattern is repeated nearly verbatim across Auto Import, Convert Database, Assess Database, Convert Statement, and Work with Tree even though references/schema-conversion-operations.md already documents it. This is more than a single padded sentence but short of the 'several unnecessary explanations' of anchor 2, placing it at efficient-with-trimmable-repetition.

4 / 5

Actionability

The body gives copy-paste-ready AWS CLI commands with exact waiter names, filter syntax ('Name=schema-conversion-operation-id,Values=<RequestIdentifier>'), polling intervals, terminal statuses, parameter placeholders, and concrete value examples (e.g., server-name short IDs, 'statement-<timestamp>' model names). The one delegated input — selection-rules JSON — has its flexibility explicitly justified by the mandatory fetch-the-docs constraint, so commands remain fully executable.

5 / 5

Workflow Clarity

Every async workflow has an explicit validation checkpoint (waiter, then SUCCESS/FAILED check with fallback polling every 30 seconds), error recovery feedback loops (waiter failure → polling; any failure → troubleshooting.md), and the destructive Clean Up flow requires explicit customer confirmation with a stated dependency-ordered deletion sequence. This matches the anchor for clear sequencing, explicit validation, and feedback loops, exceeding anchor 4 which would leave checkpoints only implicit.

5 / 5

Progressive Disclosure

The body serves as an operational hub with five real, well-signaled references ([setup-wizard.md], [action-items.md], [cancel-operations.md], [schema-conversion-operations.md], [troubleshooting.md]) that exist in the bundle and are exactly one level deep — no reference chains into further references. The 822-line setup wizard is appropriately split out of the body, and the body retains only the main-loop operations, matching the clear-overview anchor.

5 / 5

Total

19

/

20

Passed

Description

92%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 strong description: concrete, comprehensive, third-person, with an explicit trigger clause and a clearly distinct AWS-service niche. The only meaningful gap is trigger-term coverage — engine names and common synonyms that users would naturally mention are absent.

Suggestions

Add engine-specific trigger terms (e.g., SQL Server, PostgreSQL, Oracle, MySQL) to the 'Applies when' clause, since users often phrase the need as 'convert my SQL Server schema to PostgreSQL'.

Include a common synonym such as 'schema migration' or 'heterogeneous database migration' alongside 'migrating database schemas' to broaden natural-language matching.

DimensionReasoningScore

Specificity

The description enumerates seven concrete actions ("creating migration projects", "converting database schemas to a target engine", "running compatibility assessments", "navigating metadata trees", "exporting converted DDL to S3", "applying schema changes to a target database", "converting SQL statements between database engines") in third person, comprehensively covering the skill's lifecycle. This matches the anchor for multiple specific concrete actions with comprehensive coverage, and is above anchor 4 only in that no coverage gaps remain relative to the skill body.

5 / 5

Completeness

The first sentence explicitly states what the skill does, and "Applies when migrating database schemas between heterogeneous engines using AWS DMS Schema Conversion" provides an explicit, concrete when-to-use trigger. Both what and when are clearly answered, matching anchor 5; anchor 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural phrases like "migrating database schemas", "heterogeneous engines", "compatibility assessments", and "AWS DMS Schema Conversion" are present, giving good keyword coverage. It falls short of anchor 5 because common synonyms and specifics users would actually say — engine names (SQL Server, PostgreSQL, Oracle, MySQL), "schema migration" — are missing.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a named AWS service ("AWS DMS Schema Conversion") with service-specific operations (metadata trees, DDL export to S3, migration projects), forming a clear niche with distinct triggers and minimal conflict risk with other skills.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

aws/agent-toolkit-for-aws

Path

skills/specialized-skills/migration-and-modernization-skills/dms-schema-conversion/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.