converting-to-sdk-style

Convert legacy .NET project files to SDK-style format while preserving target frameworks and dependencies.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the conversion of legacy non-SDK-style .NET project files to modern SDK-style format, ensuring seamless migration and preservation of project configurations.

Core Features & Use Cases

  • Legacy to SDK Conversion: Automatically convert .NET project files to SDK-style while preserving target frameworks, dependencies, and build behavior.
  • Modernization: Facilitates migration from packages.config to PackageReference and modernizes project files for better management and compatibility.
  • Use Case: Ideal for developers who need to update their .NET projects to leverage the latest SDK features without altering the codebase.

Quick Start

Use the converting-to-sdk-style skill to convert your legacy project to SDK-style.

Frequently Asked Questions about converting-to-sdk-style

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

FAQPage Schema
How do I convert legacy .NET projects to SDK-style format?

Converting legacy .NET projects to SDK-style format involves using dedicated conversion tools that automatically migrate project files while preserving target frameworks and dependencies. This approach ensures seamless migration without altering your existing codebase.

What is the difference between packages.config and PackageReference in .NET modernization?

Migrating from packages.config to PackageReference during .NET modernization integrates NuGet dependencies directly into the SDK-style project file. This transition replaces legacy dependency management to improve build automation and project compatibility.

Does converting to SDK-style preserve my existing target frameworks and dependencies?

Yes, converting to SDK-style format preserves your existing target frameworks and dependencies. The conversion process is specifically designed to maintain original build behavior and project configurations while updating the underlying file structure.

When do I need to modernize my .NET project files to SDK-style?

You need to modernize .NET project files to SDK-style format when you want to leverage the latest SDK features, streamline build automation, and ensure better project management compatibility. This is ideal for updating legacy non-SDK-style projects.

What do I need to convert a legacy .NET project to SDK-style format?

To convert a legacy .NET project to SDK-style format, you need dedicated conversion tools and proper project ordering. These tools automate the migration workflow while ensuring your target frameworks and dependencies remain intact.

Can I use scripts to automate .NET project conversion to SDK-style?

Yes, you can use scripts to automate the .NET project conversion to SDK-style. The conversion process utilizes scripts as core components to systematically modernize legacy project files and facilitate migration from packages.config to PackageReference.