migration-transform_skill

Overview

This skill performs automated code transformations for migration tasks across a codebase. It focuses on codemods, syntax updates, API renames, import path changes, and pattern replacements while producing a risk-rated report of findings. The goal is to make large-scale edits predictable, repeatable, and verifiable so teams can migrate with confidence.

How this skill works

The skill scans code for specified patterns and applies deterministic transforms such as AST-based syntax changes, API renames, and import path rewrites. It runs linters and type checkers after edits, generates before/after diffs, and classifies each change with a risk rating (Critical, High, Medium, Low). Outputs include a summary of changed files, suggested manual fixes, and verification steps for reviewers.

When to use it

• Upgrading language versions that require syntax changes (e.g., new language constructs)
• Renaming or deprecating public APIs and updating all callers
• Refactoring module layout that requires import path updates
• Replacing obsolete patterns or utilities with modern equivalents
• Preparing a large codebase for a framework or library upgrade

Best practices

• Design transforms to be idempotent so they can be safely re-run
• Use AST-based edits rather than regex for semantic accuracy
• Run type checks and linters as part of the verification step
• Produce concise before/after diffs and attach example locations
• Mark ambiguous changes as High or Critical for manual review

Example use cases

• Automate renaming of an API method across hundreds of repositories and flag ambiguous callsites
• Migrate import paths after a library reorganization and remove stale imports
• Convert deprecated language constructs to the new syntax required by the latest compiler
• Replace an obsolete utility module with its modern replacement and update usages
• Transform configuration objects to a new schema and surface mismatches for manual correction