CtrlK
BlogDocsLog inGet started
Tessl Logo

migration-refactor-specialist

Skill para migracoes, modernizacao de legacy e refactors estruturais. Use quando precisar fazer upgrades grandes, extracao incremental, strangler pattern, compatibilidade de transicao e rollout seguro. Trigger em: "migracao de framework", "modernizacao de legacy", "strangler pattern", "refactor estrutural", "upgrade grande", "extracao incremental", "migracao de runtime", "trocar ORM", "rollout incremental de refactor", "migrar para", "spring boot 3", "spring boot 2 para 3", "jakarta migration", "javax para jakarta", "openrewrite", "upgrade spring boot", "migrar jdk 21", "jdk 21 upgrade", "java 21 migration", "spring boot upgrade", "spring 3 migration".

68

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, concise process skill with strong triggers and a concrete delete-list procedure, but its primary migration workflow relies on external playbook/policy files that are not bundled here, leaving the body's executable detail and validation feedback loops incomplete.

Suggestions

Inline a minimal phased migration sequence with explicit validate→fix→retry checkpoints (e.g., per-phase: run tests, check REPORT.md, rollback on cutoff breach) so the core workflow is actionable without opening the playbook.

Ship the referenced bundle files (playbooks/spring-boot-2-to-3.md, playbooks/references/*.md, templates/migration-plan.md) alongside SKILL.md, or inline the essential steps, so the well-signaled references resolve to real content.

Add one concrete executable example for the primary task (e.g., a sample OpenRewrite command or feature-flag rollout snippet) to lift actionability beyond framework-level guidance.

DimensionReasoningScore

Conciseness

The body is lean — short bullet checklists and section headers with no concept explanations Claude already knows, and it defers detail to playbooks/policies rather than reproducing them, so every token earns its place. Not a 2 because there is no padded or unnecessary explanation to tighten.

3 / 3

Actionability

The delete-list section is concrete and actionable (5 named categories, "citar arquivo:linha", evidence requirement, human-confirmation carve-out), but the primary migration execution detail (the "10 passos" and commands) is deferred to an external playbook not present in the bundle, leaving the core task guidance framework-level. Not a 3 because fully executable, copy-paste-ready steps for the main task are not in the body; not a 1 because concrete actionable guidance is present for the delete-list workflow.

2 / 3

Workflow Clarity

Checklist Base and Evidencia de Conclusao provide a loose sequence and mention "validacao incremental por fase" and rollback/corte criteria, but the body lacks an explicit phased step sequence with validate→fix→retry checkpoints for a risky rollout operation. Not a 3 because explicit validation feedback loops are absent for the migration workflow (capped at 2 per the batch/risky-operations note); not a 1 because sequence and validation concepts are present.

2 / 3

Progressive Disclosure

References are clearly signaled via a playbook table and bulleted descriptions of playbooks/references files, showing good one-level-deep structure, but the referenced files (playbooks/, templates/migration-plan.md, policies/, GLOBAL.md) are not present in the review bundle, so navigation and content split cannot be verified. Not a 3 because the well-signaled structure is undermined by absent referenced files; not a 1 because the body is organized into clear sections rather than a monolithic wall of text.

2 / 3

Total

9

/

12

Passed

Description

100%Weight 40%Scale 1-3

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, concise, with explicit what/when structure and an extensive list of natural trigger terms covering the migration/refactor niche. No vague fluff or over-claims.

DimensionReasoningScore

Specificity

Names multiple concrete techniques and actions — "migracoes, modernizacao de legacy e refactors estruturais", "strangler pattern", "extracao incremental", "compatibilidade de transicao e rollout seguro" — rather than vague language, matching the anchor that lists several specific concrete actions. Not a 2 because it goes beyond naming only a domain and a couple of actions.

3 / 3

Completeness

It answers both what ("Skill para migracoes, modernizacao de legacy e refactors estruturais") and when ("Use quando precisar fazer upgrades grandes..." plus an explicit "Trigger em:" list), matching the anchor that clearly answers both what AND when with explicit triggers. Not a 2 because the when is explicit, not merely implied.

3 / 3

Trigger Term Quality

The explicit "Trigger em:" list gives broad coverage of natural phrases a user would say ("migracao de framework", "spring boot 2 para 3", "javax para jakarta", "migrar jdk 21", "openrewrite"), matching the anchor for good coverage of natural terms. Not a 2 because it includes many common variations rather than just a few relevant keywords.

3 / 3

Distinctiveness Conflict Risk

It carves a clear niche — large migrations and structural refactors distinct from the normal feature/bugfix flow — with specific triggers (Spring Boot 2→3, Jakarta, JDK 21) unlikely to fire for unrelated skills. Not a 2 because the triggers are specific enough to avoid overlap with general-purpose skills.

3 / 3

Total

12

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
felvieira/claude-skills-fv
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.