CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

78

1.08x
Quality

70%

Does it follow best practices?

Impact

92%

1.08x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/framework-migration/skills/database-migration/SKILL.md

The canonical home for this skill is database-migration in wshobson/agents

SKILL.md
Quality
Evals
Security

Quality

Content

53%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—complete, runnable migration code with run/rollback commands for Sequelize, TypeORM, and Prisma—but it is too long for a SKILL.md overview and inlines material that belongs in referenced bundle files. Most critically, the six reference/asset/script paths it advertises do not exist, so progressive disclosure fails. Workflow clarity is capped at 3 because destructive batch database migrations lack a consistent explicit validate-before-proceed checkpoint despite the destructive context.

Suggestions

Move the per-ORM migration examples and the full schema/data transformation code blocks into the referenced files (references/orm-switching.md, references/schema-migration.md, references/data-transformation.md) and actually create those files so the Resources links resolve; keep SKILL.md to a concise overview plus one representative example.

Add an explicit validation checkpoint to the zero-downtime and cross-database workflows (e.g., 'Verify backfill row count matches before removing the old column; only proceed when verification passes') so destructive batch operations get a validate -> fix -> retry feedback loop and workflow_clarity can exceed 3.

Trim the volume of full code blocks—present concise idiomatic snippets rather than complete migration files, since Claude already knows createTable/addColumn/transaction patterns, to lift conciseness above 2.

DimensionReasoningScore

Conciseness

The body runs ~430 lines of largely complete migration code blocks across seven sections (ORM examples, schema/data transformations, rollback, zero-downtime, cross-database), much of which restates patterns Claude already knows (createTable, addColumn, transaction try/commit/rollback); this matches score-2's "noticeably verbose; several unnecessary or padded sections." It is above 1 because the code is accurate and sectioned rather than conceptual prose, but below 3 because the volume of full implementation examples far exceeds what a lean skill needs.

2 / 5

Actionability

Every section provides complete, copy-paste-ready executable code with run/rollback commands inline (e.g. "npx sequelize-cli db:migrate", "npx prisma migrate deploy"), matching the score-5 anchor of fully executable examples covering common cases. It is clearly above 4, which allows minor gaps, since even multi-step zero-downtime and cross-database strategies ship complete runnable migration files.

5 / 5

Workflow Clarity

Multi-step processes like the zero-downtime rename ("Step 1: Add new column... Step 2: Update application... Step 3: Remove old column") and blue-green deployment (Phases 1–5) are sequenced, but the skill is fundamentally about destructive batch database operations and lacks an explicit validate-then-proceed checkpoint loop in its workflows; per the rubric, missing validation/verification steps in destructive/batch operations caps workflow_clarity at 3. The Checkpoint-Based Rollback example does include a verification check, which keeps it from dropping to 2 where validation is entirely absent.

3 / 5

Progressive Disclosure

A Resources section lists six references (references/orm-switching.md, references/schema-migration.md, assets/schema-migration-template.sql, scripts/test-migration.sh, etc.), but none of these bundle files actually exist in the skill directory, so the inlined ~430-line body is doing work that should live in separate files; this matches score-2's "content that clearly belongs in separate files is inlined; or references are buried." It is above 1 because there is section structure and an attempt at references, but below 3 because the references are non-existent and the bulk remains inline.

2 / 5

Total

12

/

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 clearly states both the concrete capabilities (ORM migrations, zero-downtime, data transformation, rollback) and an explicit 'Use when' trigger clause covering natural user phrases. It uses appropriate third-person voice and carves a distinct niche with low conflict risk. The only minor gap is trigger-term breadth—adding synonyms and concrete file extensions (.sql, migration files, schema files) would push trigger_term_quality to a perfect score.

DimensionReasoningScore

Specificity

"Execute database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback procedures" lists several concrete actions (migrations, zero-downtime, data transformation, rollback), matching the score-4 anchor of multiple specific actions with minor coverage gaps; it falls short of 5 because it stops at four actions rather than comprehensive coverage, and is well above 3 which expects only 1–2 concrete actions.

4 / 5

Completeness

It explicitly states what ("Execute database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback procedures") and when ("Use when migrating databases, changing schemas, performing data transformations, or implementing zero-downtime deployment strategies"), matching the score-5 anchor answering both what and when with concrete trigger phrases; it is above 4 because the 'when' clause is explicit and specific rather than weakly stated.

5 / 5

Trigger Term Quality

"migrating databases, changing schemas, performing data transformations, or implementing zero-downtime deployment strategies" provides good natural keyword coverage users would say, matching score-4 (good coverage, a few natural terms missing); it is above 3 because it covers multiple natural phrases beyond a single keyword, but below 5 because it lacks synonyms and concrete file extensions like .sql, schema file, or migration file.

4 / 5

Distinctiveness Conflict Risk

"database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback procedures" carves a clear niche with distinct triggers (migrations, schemas, zero-downtime deployment), matching the score-5 anchor of a clear niche with minimal conflict risk; it is above 4 because the domain is tightly scoped to database migrations rather than broad document/file handling.

5 / 5

Total

18

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

15

/

16

Passed

Repository
Dicklesworthstone/pi_agent_rust
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.