CtrlK
BlogDocsLog inGet started
Tessl Logo

legacy-migration-planner

Use when planning legacy system migrations, codebase modernization, monolith decomposition, microservices consolidation, cross-language rewrites, or framework upgrades. Invoke for strangler fig pattern, incremental migration strategy, or refactoring roadmaps. Do NOT use for domain analysis (use domain-analysis), component sizing (use component-identification-sizing), or step-by-step decomposition plans (use decomposition-planning-roadmap).

77

Quality

71%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./packages/skills-catalog/skills/(architecture)/legacy-migration-planner/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

72%

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 excels at trigger term coverage and distinctiveness, with explicit negative boundaries that clearly separate it from related skills. Its main weakness is the absence of a 'what does this do' statement — it tells Claude when to use the skill but never describes the concrete actions or outputs the skill provides. Adding a brief capability statement would significantly improve it.

Suggestions

Add a leading sentence describing what the skill concretely does, e.g., 'Plans and guides legacy system migrations, produces incremental migration strategies, and generates refactoring roadmaps.'

Specify the outputs or deliverables the skill produces (e.g., migration plans, risk assessments, phased timelines) to strengthen the 'what' dimension.

DimensionReasoningScore

Specificity

The description names the domain (legacy system migrations, codebase modernization) and lists several scenarios, but it focuses more on 'when to use' triggers than on concrete actions the skill performs. It never explicitly states what the skill *does* — e.g., 'generates migration plans', 'produces refactoring roadmaps' — only when to invoke it.

2 / 3

Completeness

The 'when' is thoroughly addressed with explicit trigger scenarios and even negative boundaries (Do NOT use for...). However, the 'what does this do' is largely missing — the description never clearly states the concrete actions or outputs the skill produces, only the contexts in which to invoke it.

2 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: 'legacy system migrations', 'codebase modernization', 'monolith decomposition', 'microservices consolidation', 'cross-language rewrites', 'framework upgrades', 'strangler fig pattern', 'incremental migration strategy', 'refactoring roadmaps'. These are terms users would naturally use when requesting this kind of help.

3 / 3

Distinctiveness Conflict Risk

The description explicitly delineates boundaries by naming three related skills and specifying what NOT to use this skill for (domain analysis, component sizing, decomposition planning). This makes it highly distinctive and minimizes conflict risk with adjacent skills.

3 / 3

Total

10

/

12

Passed

Implementation

70%

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

This is a well-structured migration planning skill with excellent workflow clarity and progressive disclosure. Its main weakness is that actionability depends heavily on the referenced files — the SKILL.md itself lacks concrete examples (e.g., a sample domain migration file excerpt, an example file:line citation). There is also moderate redundancy between the Core Principles and Constraints sections.

Suggestions

Add a brief concrete example showing what a domain migration file entry looks like (even 10-15 lines), including the expected file:line citation format, to make the output expectations actionable without loading references.

Consolidate the Core Principles and Constraints sections — the overlap between 'Never assume' (principle 1) and 'Guess the meaning of acronyms' (MUST NOT), and between 'Always research' (principle 3) and 'Research every technology recommendation' (MUST DO) wastes tokens.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but has some redundancy — the core principles repeat constraints that appear again in the MUST DO/MUST NOT DO section (e.g., 'never assume' and 'guess the meaning of acronyms' appear in both). The ASCII workflow diagram is helpful but the surrounding prose could be tighter. Overall reasonably lean for a complex multi-phase skill.

2 / 3

Actionability

The skill provides a clear workflow structure and specific output file paths, but the actual detailed instructions are deferred to reference files (references/research-phase.md, references/plan-phase.md, etc.) that we cannot evaluate. The steps described are more procedural descriptions than fully executable guidance — there are no concrete examples of what a domain migration file should look like, no template snippets, and no example file:line citation format.

2 / 3

Workflow Clarity

The two-phase workflow (RESEARCH → PLAN) is clearly sequenced with explicit ordering constraints ('Never skip RESEARCH. Never start PLAN without completing RESEARCH.'). Each phase has numbered steps with clear outputs. The constraint that every migration step must include a rollback strategy serves as a validation checkpoint. The reference loading table provides clear conditional triggers for when to load each reference.

3 / 3

Progressive Disclosure

Excellent progressive disclosure structure. The SKILL.md serves as a clear overview with a well-organized reference table that maps six reference files to specific loading conditions. References are one level deep and clearly signaled with 'Load when' conditions. The output structure is cleanly separated into research/ and domains/ directories.

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tech-leads-club/agent-skills
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.