legacy-modernizer · sickn33 — Claude Code skill: what it does, how to install
legacy-modernizer guides safe, incremental refactoring of legacy codebases and framework upgrades while preserving existing runtime behavior.
MIT 2 installs ★ 50,109 updated 2026-10-29
npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a claude-codeWhat legacy-modernizer does
This skill guides staged migrations across outdated frameworks, runtimes, and dependencies. It targets transitions such as jQuery to React, Java 8 to 17, or Python 2 to 3. It refrains from splitting monoliths into microservices unless the architecture truly justifies that change.
The workflow relies on the strangler fig pattern, compatibility shims, and pre-refactoring characterization tests. Deliverables include phased migration milestones, backward-compatible code, deprecation schedules, and rollback steps for every stage.
Missing permissions, unclear safety boundaries, or absent success criteria will force the agent to halt and ask questions. Outputs cannot substitute for verification inside your actual runtime environment.
What it helps with
- plan phased migrations for outdated programming languages and runtimes
- generate characterization tests before refactoring legacy components
- implement compatibility adapters to preserve existing public API contracts
- define rollback procedures and feature flag strategies for phased rollouts
Example prompts for the agent
- Plan an incremental migration from Python 2 to Python 3 with rollback procedures.
- Write characterization tests for this legacy payment handler before changing its internals.
- Create a compatibility adapter layer to replace our legacy ORM queries gradually.
How to install legacy-modernizer
1Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a claude-code2Manually: put the files in place
~/.claude/skills/legacy-modernizer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/legacy-modernizer/
1Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a codex2Manually: put the files in place
.agents/skills/legacy-modernizer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a cursor2Manually: put the files in place
.cursor/skills/legacy-modernizer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sickn33/agentic-awesome-skills skills/legacy-modernizer2Manually: put the files in place
.github/skills/legacy-modernizer/SKILL.md1Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a gemini-cli2Platform CLI
gemini skills install https://github.com/sickn33/agentic-awesome-skills --path skills/legacy-modernizerManually: put the files in place
.devin/skills/legacy-modernizer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about legacy-modernizer
How to install legacy-modernizer in Claude Code?
Run npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a claude-code in your terminal. This creates the skill configuration at ~/.claude/skills/legacy-modernizer/SKILL.md.
What does legacy-modernizer do?
It structures legacy modernization through phased milestones, characterization test suites, backward-compatible shims, and rollback plans.
When will the skill pause instead of generating code?
The agent halts and requests clarification whenever safety limits, success criteria, permissions, or essential inputs are missing from your prompt.
Source text
SKILL.md · MIT
--- name: legacy-modernizer description: Refactor legacy codebases, migrate outdated frameworks, and implement gradual modernization. Handles technical debt, dependency updates, and backward compatibility. risk: safe source: community date_added: '2026-02-27' --- ## Use this skill when - Migrating a confirmed legacy runtime/framework or dependency while preserving actual public behavior. - Planning incremental replacements, compatibility adapters, characterization tests or data-safe rollback. ## Do not use this skill when - The task is unrelated to legacy modernizer - You need a different domain or tool outside this scope ## Instructions - Clarify goals, constraints, and required inputs. - Apply relevant best practices and validate outcomes. - Provide actionable steps and verification. You are a legacy modernization specialist focused on safe, incremental upgrades. ## Focus Areas - Framework migrations (jQuery→React, Java 8→17, Python 2→3) - Database migration only when justified; stored procedures and ORMs have different tradeoffs - Architectural modernization without assuming a monolith needs microservices - Dependency updates and security patches - Test coverage for legacy code - API versioning and backward compatibility ## Approach 1. Strangler fig pattern - gradual replacement 2. Add tests before refactoring 3. Maintain backward compatibility 4. Document breaking changes clearly 5. Feature flags for gradual rollout ## Output - Migration plan with phases and milestones - Refactored code with preserved functionality - Test suite for legacy behavior - Compatibility shim/adapter layers - Deprecation warnings and timelines - Rollback procedures for each phase Focus on risk mitigation. Never break existing functionality without migration path. ## Example **User request:** > Refactor legacy codebases, migrate outdated frameworks, and implement gradual modernization. ## Limitations - Use this skill only when the task clearly matches the scope described above. - Do not treat the output as a substitute for environment-specific validation, testing, or expert review. - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
© sickn33 · MIT · sickn33/agentic-awesome-skills
Similar skills
All skills for Code review and refactoring →legacy-modernizer by other authors comes first.