1k-pkg-upgrade-review

Diff package versions, trace call sites, and generate compatibility reports.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/wanghaisheng/web3-scaffold-app-monorepo --skill 1k-pkg-upgrade-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 1k-pkg-upgrade-review
Source: https://github.com/wanghaisheng/web3-scaffold-app-monorepo/tree/main/.claude/skills/1k-pkg-upgrade-review
Command: npx skills add https://github.com/wanghaisheng/web3-scaffold-app-monorepo --skill 1k-pkg-upgrade-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill automates the analysis of package version upgrades by diffing old vs new sources, tracing all call sites, and generating structured compatibility reports for SMEs and PRs.

Core Features & Use Cases

  • Diff analysis between old and new versions to surface API changes, added/removed exports, and behavior adjustments.
  • Call-site tracing across the codebase to identify impacted modules and usage patterns.
  • Generation of structured compatibility reports suitable for PRs, including recommended mitigations and rollout guidelines.
  • Use Case: When Dependabot or Renovate bumps a dependency, automatically produce a report that highlights compatibility risks and suggested remediation steps.

Quick Start

Run a package upgrade review on a lockfile change to generate a compatibility report and a PR-ready summary.

Frequently Asked Questions about 1k-pkg-upgrade-review

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

FAQPage Schema
How do I automate npm package upgrade reviews for Dependabot PRs?

Automate package upgrade reviews by diffing old and new sources, tracing all call sites, and generating a structured compatibility report. This process fetches both versions, classifies API changes, and produces a PR-ready report with recommended mitigations for Dependabot bumps.

What is call-site tracing for dependency upgrades and how does it work?

Call-site tracing for dependency upgrades identifies impacted modules and usage patterns by analyzing the codebase. It works by fetching both old and new package versions, diffing main sources to classify API changes, and mapping those changes to actual usage locations across the project.

Can I analyze package version upgrades across monorepo lockfiles?

Yes, you can analyze package version upgrades across monorepo lockfiles. The review process covers lockfiles across monorepos, diffing old vs new sources to surface API changes, removed exports, and behavior adjustments for any manual upgrades or automated dependency bumps.

What's the best way to generate a compatibility report for yarn upgrade reviews?

The best way to generate a compatibility report for yarn upgrade reviews is to fetch both package versions, diff main sources to classify API changes, trace call sites across the codebase, and output a structured PR-ready summary with recommended mitigations and rollout guidelines.

Does package upgrade diff analysis work for manual dependency bumps?

Yes, package upgrade diff analysis works for manual dependency bumps as well as automated Renovate or Dependabot PRs. It fetches both versions, classifies API changes, traces all call sites, and generates structured compatibility reports suitable for PRs.

What should a compatibility report include when reviewing package version upgrades?

A package version upgrade compatibility report should include classifications of API changes, added or removed exports, behavior adjustments, impacted modules from call-site tracing, recommended mitigations, and rollout guidelines structured for PR comments.