package-upgrade

The package-upgrade skill is designed to assist developers in managing and upgrading project dependencies in frontend JavaScript ecosystems, particularly npm-based projects. It addresses the common challenges of outdated packages, potential breaking changes, and the complexity of coordinating upgrades across multiple projects or libraries. By providing a structured, evidence-based analysis, this skill helps teams ensure that dependency updates are planned, low-risk, and aligned with best practices, reducing the likelihood of runtime issues or regressions due to incompatible versions.

This skill offers several key capabilities. It systematically inventories all package.json files in a project, cataloging dependencies and development dependencies by category, such as framework, UI, build tools, testing, and utilities. It then performs codebase usage analysis for each unique package, tracking which projects rely on them, import counts, key usage areas, and associated configuration files. Beyond inventory, the skill conducts web research on latest versions, breaking changes, and migration guides from official sources, assessing upgrade risks, and generating a phased migration plan. Confidence levels are assigned to recommendations, ensuring that only thoroughly validated guidance is presented, and any uncertainties are flagged for user verification.

Typical use cases include planning large-scale frontend upgrades, auditing dependencies before introducing new features, and ensuring compatibility across multiple micro-frontends or shared libraries. Target users are frontend developers, software architects, and DevOps teams responsible for maintaining large JavaScript or Node.js codebases. By providing detailed, evidence-backed upgrade strategies, this skill enables users to confidently update dependencies while minimizing the risk of breaking their applications, and facilitates a structured workflow from inventory through phased implementation.