deps-upgrade

Installation
SKILL.md

Dependency Upgrade Validation

The upgrade is the easy part; proving the project still coheres is the work. This skill takes over after versions are chosen -- typically bun update -i -r or an equivalent interactive pick -- and validates what landed: the real delta from git, peer and engine integrity, breaking changes and migrations across every version crossed, features worth adopting, and verification gates that run the project rather than reading about it. It also answers the inverse question: can a held-back package move, and why is it in package.json at all.

Verified against bun 1.3.14, npm 11.19.0, pnpm 11.21.0, yarn 4.18.0 (2026-08-15, the command matrix in references/package-managers.md) and gh v2.103.2 (2026-10-27, the gh release/gh api reads; unchanged since v2.102.0). The bun baseline trails the bun-cli skill (v1.4.4): for a flag that matrix does not cover, bun-cli is the current reference.

When to Use

  • Validating a batch upgrade -- "I upgraded a lot of packages, validate everything"
  • Assessing a held-back package -- "can we upgrade X?", "what blocks it?"
  • Questioning a dependency -- "why do we even have X, we don't use it"
  • Reading release notes -- breaking changes, migration steps, new features across the versions crossed
  • Post-upgrade triage -- type, build or test failures that appeared after an update
  • Pre-upgrade recon -- what a bump would cost before anyone runs it

Critical Rules

Installs
99
GitHub Stars
7
First Seen
Aug 15, 2026