dependency-upgrade

Plans and executes batched dependency upgrades with per-batch verification and isolated major-version commits.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/GregM1991/skills --skill dependency-upgrade-gregm1991
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dependency-upgrade
Source: https://github.com/GregM1991/skills/tree/main/skills/dependency-upgrade
Command: npx skills add https://github.com/GregM1991/skills --skill dependency-upgrade-gregm1991

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Blind npm update runs mix safe patches with risky major bumps into one undiagnosable commit, so when something breaks you cannot tell which dependency caused it. This Skill turns a pile of outdated packages into an ordered, risk-tiered upgrade plan executed in small verified batches with clean, auditable commits. ## Core Features & Use Cases - Risk-tiered batching: Classifies outdated packages by type (direct/dev/transitive), bump kind (patch/minor/major), and blast radius, then orders them dev patches first, runtime majors last, one major per commit. - Verification between batches: Runs build, full test suite, lint, and smoke tests after every batch, with recovery guidance for trivial vs. non-trivial breakage. - Stuck-major handling: Reads migration guides, scopes breaking changes with ripgrep, and either upgrades in a dedicated slice or pins with a documented reason. - Use Case: Responding to a security advisory on a direct dependency while also doing a monthly hygiene pass — inventory with npm outdated and npm audit, present the batch plan, execute each batch with its own commit, and produce a summary of completed, deferred, and intentionally pinned upgrades. ## Quick Start Ask the assistant to upgrade the project's outdated dependencies safely in verified batches with one commit per major version.

Frequently Asked Questions about dependency-upgrade

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

FAQPage Schema
How do I upgrade npm dependencies safely without breaking the build?▼

Upgrade in risk-ordered batches instead of running npm update: dev dependency patches first, then runtime patches, minors, and finally each major in its own commit. Run the full build, test suite, and linter after every batch so failures are isolated to a known set of packages.

How to handle a breaking major version upgrade like React 18 to 19?▼

Read the official migration guide first, then scope the blast radius by searching for changed symbols with ripgrep. Either do the migration as its own dedicated slice of work, or pin the current major and file a follow-up if the migration effort is too large for now.

Does this dependency upgrade process work with pnpm, yarn, or Python?▼

Yes, the workflow is ecosystem-agnostic. It covers npm, pnpm, and yarn for Node, pip and uv for Python, cargo for Rust, bundler for Ruby, and go modules for Go, using each tool's outdated and audit commands.

Why should major version bumps be in separate commits?▼

Major versions are where real breaking changes live, so isolating them keeps the commit history truthful. If a batch containing multiple majors breaks something, you cannot tell which dependency caused the failure without bisecting.

What should I do when a dependency upgrade fails the test suite?▼

Investigate before moving on rather than skipping the batch. Trivial breakage like renames gets fixed in the same commit; non-trivial breakage means splitting the batch, upgrading the safe packages now, and handling the problem dependency separately.