database-migration

Execute database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback procedures. Use when migrating databases, changing schemas, performing data transformations, or implementing zero-downtime deployment strategies.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

82%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 body is a strong, code-dense reference with executable examples and explicit rollback strategies including a verification checkpoint. It loses points for a few redundant comments, missing inter-step validation in the zero-downtime flows, and a single end-of-file reference pointer rather than contextualized per-section links.

Suggestions

Add explicit validation checkpoints between the backfill and cutover steps of the zero-downtime rename and type-change flows (e.g., verify row counts or non-null integrity before removing the old column).

Trim self-evident inline comments that restate the following code line to improve token efficiency.

Contextualize the references/details.md pointer near the relevant sections (e.g., next to the zero-downtime or cross-database patterns) rather than only at the end of the file.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with dense, relevant code and no padding about basic concepts, though several inline comments restate what the code does (e.g., '// Get all records', '// Drop old column') and could be trimmed.	4 / 5
Actionability	Provides fully executable, copy-paste-ready code across Sequelize, TypeORM, and Prisma with explicit run and rollback commands covering common migration cases.	5 / 5
Workflow Clarity	Multi-step destructive flows (rename, type change) are clearly sequenced and the checkpoint-based rollback includes a verification check, but the zero-downtime rename/type-change flows lack explicit validation checkpoints between backfill and cutover steps.	4 / 5
Progressive Disclosure	A clearly signaled one-level-deep reference to references/details.md exists and section headers organize the body, though the pointer appears only at the very end rather than contextualized per section, and some inlined patterns could live in details.md.	4 / 5
	Total	17 / 20 Passed

Description

87%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 strong: it states concrete capabilities and provides an explicit 'Use when' trigger clause with natural keywords. Minor specificity gaps (broad terms like 'platforms') keep it just below perfect on trigger term quality and specificity.

Dimension	Reasoning	Score
Specificity	Lists several concrete capabilities (zero-downtime strategies, data transformation, rollback procedures, ORM/platform migrations) but terms like 'platforms' and 'data transformation' remain somewhat broad, leaving minor coverage gaps.	4 / 5
Completeness	Explicitly states what the skill does and includes a 'Use when...' clause with concrete trigger phrases, answering both what and when.	5 / 5
Trigger Term Quality	Natural triggers like 'migrating databases, changing schemas, performing data transformations, zero-downtime deployment strategies' are present, though common synonyms (schema migration, specific ORM names) are missing.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (database migrations across ORMs with rollback and zero-downtime strategies) with specific triggers and minimal overlap with unrelated skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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: wshobson/agents
Path: plugins/framework-migration/skills/database-migration/SKILL.md
Commit: d6837ae

Reviewed: about 12 hours ago

Table of Contents

Discovery Implementation Validation

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.