aspire-version-upgrade

Automate Aspire project upgrades with package, TFM, and configuration migrations.

19|2|Updated May 13, 2026
One-click install
npx skills add https://github.com/microsoft/upgrade-agent-plugins --skill aspire-version-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aspire-version-upgrade
Source: https://github.com/microsoft/upgrade-agent-plugins/tree/main/plugins/upgrade-agent/extenders/upgrade-dotnet/upgrade/skills/scenarios/aspire-version-upgrade
Command: npx skills add https://github.com/microsoft/upgrade-agent-plugins --skill aspire-version-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aspire, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Manages the upgrade process for Aspire projects to newer versions, automating the detection of breaking changes, code transformations, and validations.

Core Features & Use Cases

  • Automated Upgrade Path: Handles package version bumps, renames, and breaking API changes.
  • TFM Upgrades: Updates target frameworks to match Aspire version requirements.
  • Configuration Migration: Migrates legacy configuration files to the unified format.
  • Use Case: Upgrade an existing Aspire project from version 8.x to 13.2, ensuring all components are compatible and functional post-upgrade.

Quick Start

Run the 'aspire upgrade my project to 13.2' command to upgrade your Aspire project to the latest version.

Frequently Asked Questions about aspire-version-upgrade

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

FAQPage Schema
How do I upgrade an Aspire project to a newer version?

Upgrading an Aspire project is automated by running the 'aspire upgrade my project to 13.2' command, which handles package version bumps, code transformations, and configuration migrations to ensure compatibility.

What does an Aspire version upgrade actually do to my code?

An Aspire version upgrade automates the detection of breaking changes and applies code transformations. It updates package versions, handles API renames, and migrates legacy configuration files to the unified format.

Can I use this automated upgrade tool for my Aspire 8.x projects?

Yes, you can use this tool to upgrade existing Aspire projects from version 8.x to 13.2. It is specifically designed to handle version transitions and ensure all components remain compatible and functional.

Do I need to update target frameworks when upgrading Aspire versions?

Yes, TFM upgrades are required when upgrading Aspire versions. The upgrade process automatically updates your target frameworks to match the specific version requirements of the newer Aspire release.

How are legacy configuration files handled during an Aspire upgrade?

During an Aspire upgrade, legacy configuration files are automatically migrated to a unified format. This configuration migration ensures your project setup aligns with the newer version's structural requirements.

What is the best way to handle breaking API changes in Aspire?

The best way to handle breaking API changes in Aspire is through the automated upgrade path. It detects breaking changes, applies necessary code transformations, and validates the project to ensure functional compatibility.