Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sickn33/agentic-awesome-skills --skill legacy-modernizer -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/legacy-modernizer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/legacy-modernizer/

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.

legacy-modernizer https://github.com/Jeffallan legacy-modernizer — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that produces incremental migration plans for aging codebases. It maps dependencies and designs API facades before any production code changes. CX Codex +1 4,700installs legacy-modernizer Dokhacgiakhoa legacy-modernizer refactors aging systems piece by piece without downtime. Routes traffic between old and new code using the Strangler Fig pattern, retiring legacy modules only when replacements are solid. CX Codex +1 1installs code-refactoring-legacy-modernizer Seth Hobson code-refactoring-legacy-modernizer — a subagent for Claude Code, Codex, and Cursor that moves legacy codebases forward through incremental framework migrations and technical debt paydown. CX Codex ★ 42,780repo stars working-with-legacy-code wondelai working-with-legacy-code — a skill that applies Michael Feathers' method for safe changes to untested code. Triggers when you work with legacy code, hunt for characterization tests, or break dependencies to get modules under test. CX Codex +1 3,700installs refactor-legacy-code aj-geddes refactor-legacy-code guides systematic legacy code refactoring without breaking features. Built for paying down technical debt and replacing deprecated patterns. CX Codex +1 611installs working-effectively-with-legacy-code ciembor working-effectively-with-legacy-code — a skill for Claude Code and Codex that enforces Michael Feathers' legacy code techniques. Activates during risky refactoring, missing test coverage, and dependency breaking. CX Codex +1 602installs modernize-verify official Anthropic Re-runs verification of modernized code independently and assigns each module one verdict: PROVEN, PARTLY PROVEN, or NOT PROVEN. The verdict comes from a script with fixed rules, not from the agent. CX Codex +1 ★ 47,914repo stars documenting-legacy-codebases riekelt documenting-legacy-codebases rebuilds documentation from the code itself when the existing docs are missing, stale or untrusted. Survey first, prose second. CX Codex +1 26,600installs

From the same set187

The whole set →
mobile-security-coder mobile-security-coder adds secure mobile development practices to your AI assistant: covers input sanitization, WebView hardening, and secure Keychain or Keystore storage. CX Codex +1 3installs frontend-security-coder The frontend-security-coder skill for Claude Code secures client-side code and blocks interface vulnerabilities. It activates during frontend hardening and XSS mitigation tasks. CX Codex +1 2installs docs-architect The docs-architect Claude Code skill examines a codebase and turns its architecture and implementation details into technical documentation. It handles requests for system guides, component explanations, and design rationale. CX Codex +1 2installs network-engineer The network-engineer skill for Claude Code sets up cloud networking, security architectures, and performance optimization. Runs when designing infrastructure and troubleshooting routing. CX Codex +1 2installs employment-contract-templates employment-contract-templates — a skill for generating employment contracts, offer letters, and HR policies tailored to specific jurisdictions. Works on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 2installs code-refactoring-tech-debt code-refactoring-tech-debt analyzes code and git history to identify technical debt, estimate development drag, and prioritize refactoring tasks with clear trade-offs. CX Codex +1 2installs stitch-ui-design stitch-ui-design guides you in writing prompts for Google Stitch to generate web and mobile UI designs. Use it to specify screens, visual direction, responsive behavior, and interactions. CX Codex +1 2installs programmatic-seo A skill for designing programmatic SEO systems: evaluates feasibility, picks a template strategy, and guards against thin content. CX Codex +1 2installs

Project sponsors

Companies that keep this analytics open