# Safe Upgrade Pr

> Ship minimal, test-verified dependency upgrades as focused PRs

- Skill: `andrewyng/safe-upgrade-pr` (Agent Skill)
- Install (CLI): `npx get-skill add andrewyng/safe-upgrade-pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/andrewyng/safe-upgrade-pr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: andrewyng (https://skillmd.com/u/andrewyng)
- Updated: 2026-11-17
- Page: https://skillmd.com/skills/andrewyng/safe-upgrade-pr

---

Turn triaged advisories into upgrade PRs a reviewer can merge without fear.

1. One branch per ecosystem (`security/deps-npm`, `security/deps-python`), smallest
   viable bumps: the fixed-in patch/minor, not "latest". Majors get their own branch
   and a migration note.
2. Regenerate lockfiles with the repo's OWN toolchain (`npm install pkg@ver`,
   `uv lock`, `poetry update pkg` …) — never hand-edit a lockfile.
3. Verify before proposing: clean install, build, and the project's test suite. Red
   suite → investigate; if the bump itself breaks the build, document what's entangled
   and propose the next-smallest path instead of forcing it.
4. PR body per upgrade: advisory id(s) closed, package old→new version, reachability
   verdict from the audit (one line), and the verification commands run. Skip CVE
   boilerplate walls — link the advisory instead.
5. Leave `accept-with-note` advisories OUT of the PR; record them in the PR body's
   "consciously not fixed" list with their justification, so the decision is visible
   and revisitable.
6. Never merge your own upgrade PR — deliver it with what a reviewer should check
   (typically: lockfile diff sanity and the test run).

