migration-resolver_skill

Overview

This skill performs dependency resolution focused on migrations. It identifies version conflicts, transitive issues, peer dependency problems, and overall dependency tree health to produce actionable remediation guidance. The skill outputs findings with clear risk ratings to prioritize fixes during a migration.

How this skill works

The skill inspects direct and transitive dependency graphs, evaluates version ranges and pinned versions, and validates peer dependency declarations. It audits lock files, checks for duplicate or abandoned packages, and flags vulnerabilities and licensing concerns. Results are summarized with risk levels and recommended actions for each issue.

When to use it

• Before upgrading major framework or library versions during a migration
• When resolving build or runtime errors caused by dependency changes
• While preparing release branches to ensure reproducible installs
• If peer dependency warnings appear after bumping packages
• When transitive upgrades introduce unexpected behavior or license changes

Best practices

• Map the full dependency tree to understand direct and indirect impacts
• Prefer small, incremental version bumps and validate tests after each change
• Use lock files and CI reproducible installs to avoid environment drift
• Document overridden or pinned versions and reasons for future audits
• Prioritize critical and high risks that block migration before medium and low

Example use cases

• Resolve conflicting semver ranges between multiple packages preventing an upgrade
• Detect diamond dependency conflicts where two packages require incompatible sub-dependencies
• Validate peer dependency ranges for plugins after core library major version bumps
• Identify abandoned or vulnerable transitive dependencies that need replacement
• Confirm lock file consistency before cutting a migration release