upgrade

Orchestrates deterministic stack tools to perform in-place version upgrades with gap and risk reporting.

1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill upgrade-vickysrawat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrade
Source: https://github.com/vickysrawat/AI-Assisted-development/tree/main/skills/upgrade
Command: npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill upgrade-vickysrawat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading a working application to a newer framework or language version is risky: breaking changes are easy to miss, cross-runtime moves get mistaken for simple upgrades, and hand-editing large codebases introduces regressions. This Skill removes that guesswork by classifying whether a change is a true in-place upgrade, grounding every breaking-change claim in authoritative sources, and driving the stack-native upgrade tool instead of hand-authoring code. ## Core Features & Use Cases - Classification & false-upgrade rejection: Detects stack and version, then rejects cross-runtime moves (e.g., .NET Framework to .NET, AngularJS to Angular, Python 2 to 3) and routes them to a rewrite workflow before any edit occurs. - Decision-grade Gap + Risk report: Produces a feasibility report with VERIFIED/INFERRED source tags, a dependency ledger flagging packages with no target-compatible version, and a multi-hop version path — valuable even if you never proceed. - Gated, bisectable execution: Runs the deterministic tool (dotnet upgrade-assistant, ng update, OpenRewrite, pyupgrade, npm-check-updates) one commit per version hop on an isolated branch off a baseline tag, with every residual fix behind an approval gate. - Use Case: You need to move a solution from .NET 6 to .NET 8. The Skill plans the 6→7→8 hop sequence, reports breaking changes with dated official sources, then drives upgrade-assistant per hop and verifies against the pre-upgrade baseline. ## Quick Start Ask the assistant to upgrade my project from .NET 6 to .NET 8 and produce the gap and risk report before making any changes.

Frequently Asked Questions about upgrade

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

FAQPage Schema
How do I upgrade a .NET project from version 6 to 8?

The Skill detects the current version, plans the multi-hop path (6 to 7 to 8), and drives the dotnet upgrade-assistant tool with one commit per hop on an isolated branch. A gap and risk report with sourced breaking changes is produced before any edit.

What is the difference between an upgrade and a rewrite?

An upgrade is an in-place, same-stack version bump handled by a deterministic tool. Cross-runtime moves like .NET Framework to .NET, AngularJS to Angular, or Python 2 to 3 are classified as false-upgrades and routed to a rewrite workflow with no edits made.

Which stacks and tools are supported for in-place upgrades?

Supported stacks are dotnet (upgrade-assistant), angular (ng update), java (OpenRewrite via Maven), python (pyupgrade), nodejs and react (npm-check-updates). Unsupported stacks stop immediately with a list of supported options.

What happens if the required upgrade tool is not installed?

The preflight probe reports the tool as missing or outdated and prints exact per-OS install and verify commands for the developer to run. The Skill pauses gracefully and never installs anything itself.

Can I get the risk report without changing any code?

Yes. The Gap + Risk report is the headline deliverable and is emitted whether or not you proceed. It classifies each item as GREEN, YELLOW, RED, or BLOCKER with VERIFIED or INFERRED source tags and a dependency ledger.

Why does the upgrade stop at a BLOCKER verdict?

A dependency with no target-compatible version is a hard blocker with no in-place path. The Skill still emits a decision-grade report explaining why and listing options, but never softens a blocker to force the upgrade forward.