upgrade-packages-js

Upgrade JavaScript/TypeScript dependencies with breaking change detection and Git safety.

27|9|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill upgrade-packages-js
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrade-packages-js
Source: https://github.com/georgekhananaev/claude-skills-vault/tree/main/.claude/skills/upgrade-packages-js
Command: npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill upgrade-packages-js

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps JavaScript/TypeScript projects upgrade dependencies safely by avoiding breaking changes and guiding migrations through codemods, tests, and reports.

Core Features & Use Cases

  • Git-safe upgrades with dedicated branches to prevent direct changes to main.
  • Detects package managers and lockfiles, then applies an incremental upgrade strategy (patch/minor/major).
  • Checks for breaking changes using official docs, changelogs, and migration guides; applies codemods when available.
  • Generates upgrade reports and keeps a record of skipped packages for traceability.
  • Suitable for monorepos and complex dependency graphs across npm, pnpm, and yarn.

Quick Start

Upgrade packages to begin an incremental upgrade process:

  • Command: upgrade packages
  • Command: upgrade react@latest
  • Command: check outdated

Frequently Asked Questions about upgrade-packages-js

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely upgrade JavaScript dependencies with breaking changes?

To safely upgrade JavaScript dependencies, this skill detects breaking changes using official changelogs, applies codemods for migrations, and verifies tests and builds across npm, pnpm, and yarn environments.

What's the best way to handle major version upgrades in a TypeScript monorepo?

For major version upgrades in a TypeScript monorepo, it applies an incremental upgrade strategy per major version, checks ESM/CJS compatibility, and manages complex dependency graphs safely.

Can I upgrade npm packages directly on my main Git branch?

You should not upgrade npm packages directly on main; this skill enforces Git safety gating by requiring dedicated branches to prevent direct changes and ensure traceability.

How does codemod migration work for outdated JavaScript packages?

Codemod migration for outdated JavaScript packages works by automatically applying code transformations required by new major versions, which are identified by checking official docs and migration guides.

What happens to skipped packages during a dependency upgrade?

Skipped packages during a dependency upgrade are documented and kept in a record for traceability, ensuring you receive a comprehensive upgrade report detailing what was left out and why.

Does this dependency upgrade workflow verify Node engine compatibility?

Yes, the dependency upgrade workflow verifies Node engines alongside ESM and CJS compatibility to ensure your upgraded JavaScript or TypeScript packages run correctly in your specific environment.