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.
89
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that excels across all dimensions. It provides specific concrete actions, uses natural trigger terms that users would actually say, explicitly addresses both what the skill does and when to use it, and carves out a distinct niche around database migrations that minimizes conflict risk with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Execute database migrations', 'zero-downtime strategies', 'data transformation', and 'rollback procedures'. Also specifies scope with 'across ORMs and platforms'. | 3 / 3 |
Completeness | Clearly answers both 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'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'database migrations', 'migrating databases', 'changing schemas', 'data transformations', 'zero-downtime deployment', 'rollback'. These cover common variations of how users would describe these tasks. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused on database migrations specifically, with distinct triggers like 'migrations', 'schemas', 'zero-downtime', and 'rollback' that are unlikely to conflict with general database query skills or other development skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with excellent code examples covering multiple ORMs and migration scenarios. The main weaknesses are some verbosity in introductory sections and missing explicit validation checkpoints in most migration workflows. The progressive disclosure and actionability are strong, making this a useful reference for database migrations.
Suggestions
Remove or significantly trim the 'When to Use This Skill', 'Best Practices', and 'Common Pitfalls' sections - these contain generic advice Claude already knows
Add explicit validation steps to migration workflows (e.g., 'Verify row counts match before and after', 'Check for constraint violations') especially for data transformation migrations
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some unnecessary content like the 'When to Use This Skill' list that Claude can infer, and the 'Best Practices' and 'Common Pitfalls' sections contain generic advice Claude already knows. The code examples are appropriately detailed but the overall document could be tightened. | 2 / 3 |
Actionability | Excellent executable code examples across multiple ORMs (Sequelize, TypeORM, Prisma) with complete, copy-paste ready migrations. Includes specific CLI commands for running and rolling back migrations, and concrete SQL queries for data transformations. | 3 / 3 |
Workflow Clarity | The zero-downtime migration section shows a clear 5-phase sequence, and transaction-based migrations include error handling. However, the overall document lacks explicit validation checkpoints between steps - for example, the checkpoint-based rollback example is good but most other migrations don't include verification steps before proceeding. | 2 / 3 |
Progressive Disclosure | Well-organized with clear section headers, and appropriately references external files (references/orm-switching.md, scripts/test-migration.sh, etc.) for detailed content. The main document serves as a comprehensive overview without requiring deep nesting to find information. | 3 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.