dotnet avatar

Migrate Dotnet10 To Dotnet11

This handles the tedious work of upgrading a .NET 10 codebase to .NET 11, including all the breaking changes that come with C# 15, runtime updates, and library changes. It walks through updating target frameworks, fixing build errors from new compiler rules (like span collection expression safe-context changes), addressing EF Core and ASP.NET Core breaking changes, and updating your CI/CD setup. The workflow is methodical with commits at logical boundaries, and it pulls from loaded reference docs covering everything through Preview 3. Use it when you're actually migrating an existing net10.0 project, not for greenfield work or cosmetic refactoring. The skill assumes you already have the .NET 11 SDK installed and starts from there.

skills.sh installs
4.1K
GitHub stars
5.9K
last updated
Aug 21, 2026

Install

$ npx -y skills add dotnet/skills --skill migrate-dotnet10-to-dotnet11 --agent claude-code

Installs into .claude/skills of the current project.

Files

.NET 10 → .NET 11 Migration

Migrate a .NET 10 project or solution to .NET 11, systematically resolving all breaking changes. The outcome is a project targeting net11.0 that builds cleanly, passes tests, and accounts for every behavioral, source-incompatible, and binary-incompatible change introduced in .NET 11.

Note: .NET 11 is currently in preview. This skill covers breaking changes documented through Preview 3.

When to Use

  • Upgrading TargetFramework from net10.0 to net11.0
  • Resolving build errors or new warnings after updating the .NET 11 SDK
  • Adapting to behavioral changes in .NET 11 runtime, ASP.NET Core 11, or EF Core 11
  • Updating CI/CD pipelines, Dockerfiles, or deployment scripts for .NET 11
  • Fixing C# 15 compiler breaking changes after SDK upgrade

When Not to Use

  • The project already targets net11.0 and builds cleanly — migration is done
  • Upgrading from .NET 9 or earlier — address the .NET 9→10 breaking changes first
  • Migrating from .NET Framework — that is a separate, larger effort
  • Greenfield projects that start on .NET 11 (no migration needed)

Inputs

Sponsors

Details

Repository
github.com/dotnet/skills
Categories
DevOps & CI/CD, Documentation, .NET & C#
First seen
Jun 3, 2026

More from dotnet/skills

All 102
1dotnet avatarmtp-hot-reloaddotnet/skillsSuggests using Microsoft Testing Platform (MTP) hot reload to iterate fixes on failing tests without rebuilding. Use when user says "hot reload tests", "iterate4.1Kskills.sh installs
2dotnet avatarincluding-generated-filesdotnet/skillsFix MSBuild targets that generate files during the build but those files are missing from compilation or output. USE FOR: generated source files not compiling (4.1Kskills.sh installs
3inngest avatarinngest-durable-functionsinngest/inngest-skillsUse when building functions that must survive process crashes, retry automatically on failure, run on a schedule, react to events, or maintain state across infr4Kskills.sh installs
4coralogix avatarcx-cost-optimizationcoralogix/cx-cliUse this skill when the user asks to "check data usage", "list TCO policies", "reduce Coralogix costs", "optimize observability spend", "lower our logging bill"4Kskills.sh installs
5coralogix avatarcx-dashboardscoralogix/cx-cliBuild and deploy a Coralogix dashboard for a given service from its logs, spans, metrics, and service specs. Discovers telemetry via cx CLI commands, emits impo4Kskills.sh installs
6starchild-ai-agent avatarpreview-devstarchild-ai-agent/official-skillsFrontend & fullstack development with live preview. Use when the user wants to build a web page, frontend app, fullstack project, or any web UI — including Reac4Kskills.sh installs