CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migration-architect

Zero-downtime migration planning, compatibility validation, and rollback strategy generation. Tools for system, database, and infrastructure migrations with minimal business impact. Use when planning a database migration, infrastructure cutover, system replacement, or any high-risk transition that needs explicit rollback paths.

56

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/migration-architect/SKILL.md

The canonical home for this skill is migration-architect in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

45%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 skill has an excellent executable core — the Quick Start's chained commands and approval gate are exactly what a migration skill should lead with — but it is buried under an encyclopedia of generic migration patterns Claude already knows, and every referenced bundle file (scripts, assets, expected outputs) is missing. The result is a monolithic 428-line SKILL.md that wastes the context window and points users at paths that don't exist.

Suggestions

Move the Migration Patterns, Data Validation, Rollback Strategies, and Risk Assessment sections (~350 lines of generic knowledge) into a references/patterns.md file and keep only a one-line index in SKILL.md, surfacing the Quick Start workflow as the main body.

Ship the referenced bundle files (scripts/migration_planner.py, compatibility_checker.py, rollback_generator.py, assets/ samples, expected_outputs/) or remove the references — currently every referenced path is broken, which caps actionability and progressive disclosure.

Either delete the inline code samples (MigrationFeatureFlag, MigrationCircuitBreaker, Terraform, CI/CD) as re-teaching of standard knowledge, or replace them with runnable, skill-specific examples that integrate with the planner/checker/generator workflow.

DimensionReasoningScore

Conciseness

The Quick Start and gate are tight, but roughly 350 of the 428 lines re-teach patterns Claude already knows verbatim — expand-contract, dual-write, CDC, strangler fig, canary, blue-green, circuit breakers, generic risk matrices, and filler like "Use cloud migration tools and services." This is noticeably-to-severely padded; the genuinely skill-specific content is a small fraction of the token budget.

2 / 5

Actionability

The Quick Start gives concrete chained commands (migration_plan.json → compatibility.json → rollback runbook) with named output fields, which is strong — but the referenced scripts/migration_planner.py, compatibility_checker.py, and rollback_generator.py do not exist in the bundle, so the commands cannot actually run. The inline Python (MigrationCircuitBreaker references a never-initialized self.new_service) and the Terraform/CI snippets are illustrative sketches rather than executable code, matching the 3 anchor.

3 / 5

Workflow Clarity

The Quick Start sequence (plan → check compatibility → generate rollback) is clearly ordered, outputs chain explicitly, and the Gate section defines validation criteria (exit 0 / owner sign-off, runbook per phase) plus a re-run instruction after schema revision — genuine feedback loops. It falls short of the 5 anchor because the broader pre/during/post checklists and pattern guidance are not integrated into that workflow, leaving minor validation gaps.

4 / 5

Progressive Disclosure

The body references scripts/, assets/, and expected_outputs/ files that are absent from the bundle (broken navigation), while ~350 lines of pattern reference material that clearly belongs in separate reference files are inlined in SKILL.md. This matches the 2 anchor ('content that clearly belongs in separate files is inlined'); it is above the 1 anchor only because section headers and a real Quick Start provide some structure.

2 / 5

Total

11

/

20

Passed

Description

83%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: third-person voice, concrete capability list, and an explicit 'Use when' trigger clause covering the main migration scenarios. Its only weaknesses are a trigger list that omits common phrasings like schema/data migration and an action list slightly thinner than what the skill body actually delivers.

DimensionReasoningScore

Specificity

The description names several concrete capabilities — "Zero-downtime migration planning, compatibility validation, and rollback strategy generation" — plus the domain ("system, database, and infrastructure migrations") and tooling. It stops short of the 5 anchor's comprehensive action list (e.g., schema evolution analysis and API versioning detection covered in the body are absent here).

4 / 5

Completeness

Both halves are explicit: the "what" is "Zero-downtime migration planning, compatibility validation, and rollback strategy generation" and the "when" is the concrete trigger clause "Use when planning a database migration, infrastructure cutover, system replacement, or any high-risk transition that needs explicit rollback paths." This matches the 5 anchor directly; the 4 anchor's softer 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

"database migration", "infrastructure cutover", "system replacement", "high-risk transition", and "rollback paths" are phrases a user would plausibly say. A few natural variants are missing ("schema migration", "data migration", "moving to a new database/cloud"), keeping it below the 5 anchor's synonym-complete coverage; it is clearly above the 3 anchor's "some relevant keywords".

4 / 5

Distinctiveness Conflict Risk

The zero-downtime/rollback-strategy framing carves a fairly distinct niche with concrete triggers, but it could still overlap with generic database-administration or deployment/CI skills. Minor overlap risk with closely related skills fits the 4 anchor; the 5 anchor's 'clear niche with minimal conflict risk' is slightly undercut by how broad "any high-risk transition" is.

4 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/migration-architect/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.