CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

framework-migration-legacy-modernize

Orchestrate a comprehensive legacy system modernization using the strangler fig pattern, enabling gradual replacement of outdated components while maintaining continuous business operations through ex

Quality

68%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/framework-migration-legacy-modernize/SKILL.md

The canonical home for this skill is framework-migration-legacy-modernize in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

A well-sequenced, highly actionable orchestration workflow with genuine validation and rollback checkpoints, undermined by padding (the extended-thinking block and generic instruction bullets) and a broken reference to a nonexistent playbook file. The core guidance is strong; the packaging around it needs tightening.

Suggestions

Delete the '[Extended thinking: ...]' paragraph (Claude already knows the strangler fig pattern) and the generic 'Instructions' bullets to cut padding.

Fix or create the `resources/implementation-playbook.md` reference — it currently points to a nonexistent file; either ship the file or remove the pointer.

Consider moving the per-phase subagent prompts into one referenced playbook file, keeping only the phase overview, configuration options, and success criteria in SKILL.md.

DimensionReasoningScore

Conciseness

The phase prompts are dense and earn their tokens, but the '[Extended thinking: The strangler fig pattern, named after the tropical fig tree...]' block explains a concept Claude already knows, and the generic 'Instructions' bullets ('Clarify goals, constraints, and required inputs') plus the near-empty Use/Do-not-use sections add padding. Mostly efficient with some unnecessary explanation, matching anchor 3.

3 / 5

Actionability

The body gives concrete subagent types, full verbatim Task-tool prompts, expected outputs, configuration flags, and quantified success criteria — near copy-paste guidance. It falls short of anchor 5 due to placeholders requiring fill-in ('[list from prioritized roadmap]', '$ARGUMENTS', 'python-pro or golang-pro (based on target stack)') and reliance on subagent types whose availability is not established. Clearly above anchor 3, which would require pseudocode or missing key details.

4 / 5

Workflow Clarity

Five phases are clearly ordered with each step consuming the previous step's outputs ('Context from previous', 'Expected output'), and explicit validation and feedback loops are present: characterization tests before refactoring, contract tests in CI, automatic rollback triggers ('error rate >1%, latency >2x baseline'), staged rollout 5%→25%→50%→100% with 24-hour observation periods, and 30-day zero-traffic verification before decommissioning. This matches the anchor-5 example of a clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

Section structure is good (phases, configuration, success criteria), but all five phases of detailed prompts are inlined in one ~135-line file, and the single reference — 'open `resources/implementation-playbook.md`' — points to a file that does not exist (no references/, scripts/, assets/, or resources/ bundle is present), so navigation to detail is broken. Structure present but the reference is neither clearly signaled as part of a real bundle nor usable, matching anchor 3.

3 / 5

Total

15

/

20

Passed

Description

53%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 communicates a clear niche and 'what', but it is buzzword-heavy, lacks any 'when to use' trigger clause, omits natural keywords like 'legacy code' and 'migration', and is truncated mid-sentence. It sits at the mediocre midpoint of the scale.

Suggestions

Add an explicit 'Use when...' clause naming concrete triggers, e.g. 'Use when the user mentions legacy code, modernizing a monolith, system migration, or the strangler fig pattern.'

Replace abstract phrasing ('comprehensive', 'enabling gradual replacement') with concrete actions such as 'assesses technical debt, builds characterization tests, and routes traffic incrementally to replacement components'.

Fix the truncation — the description ends mid-word ('through ex') and should be completed within the length limit.

DimensionReasoningScore

Specificity

Names the domain ('legacy system modernization using the strangler fig pattern') and a couple of actions ('gradual replacement of outdated components', 'maintaining continuous business operations'), but the actions are abstract and buzzword-tinged ('comprehensive', 'enabling') rather than a list of concrete operations, matching anchor 3. Not 4 because it does not enumerate several specific actions; not 2 because more than minimal action is stated.

3 / 5

Completeness

The 'what' is clearly stated (orchestrate gradual legacy modernization via the strangler fig pattern), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. The description is also truncated mid-word ('through ex'), further limiting what is explicitly stated.

3 / 5

Trigger Term Quality

'legacy system modernization' and 'strangler fig pattern' are relevant keywords, but common natural phrasings users would actually say — 'legacy code', 'migration', 'refactoring', 'monolith' — are missing. Some relevant keywords but missing common variations, matching anchor 3 rather than 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

'Legacy system modernization using the strangler fig pattern' carves a clear niche with distinct terminology; only minor overlap risk with closely related refactoring or migration skills. Matches anchor 4 ('mostly distinct; minor overlap risk') rather than 5, since no explicit trigger phrases distinguish it from those neighbors.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/framework-migration-legacy-modernize/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.