migrate-vstest-to-mtp

Migrate .NET test projects from VSTest to Microsoft.Testing.Platform.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/kierunb/ReliableAppDemo --skill migrate-vstest-to-mtp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-vstest-to-mtp
Source: https://github.com/kierunb/ReliableAppDemo/tree/main/.github/skills/dotnet-test/skills/migrate-vstest-to-mtp
Command: npx skills add https://github.com/kierunb/ReliableAppDemo --skill migrate-vstest-to-mtp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates a .NET solution from VSTest-based test execution to the Microsoft.Testing.Platform (MTP) runner, enabling unified test execution and updated CI/CD workflows across the solution.

Core Features & Use Cases

  • Supports MSTest, NUnit, and xUnit.net v2 (via YTest.MTP.XUnit2) and xUnit.net v3 (native MTP), ensuring a smooth transition of test execution to MTP.
  • Guides configuration changes including Directory.Build.props and global.json, translates dotnet test arguments, and updates CI/CD pipelines for MTP-based testing.
  • Addresses test discovery, filtering, and migration pitfalls to help teams migrate with minimal disruption.

Quick Start

Run the migrate-vstest-to-mtp workflow on your solution to migrate all test projects from VSTest to MTP and update CI configurations.

Frequently Asked Questions about migrate-vstest-to-mtp

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

FAQPage Schema
How do I migrate my .NET test projects from VSTest to Microsoft Testing Platform?

Migrating from VSTest to Microsoft Testing Platform (MTP) involves enabling the MTP runner, updating Directory.Build.props, and translating dotnet test CLI arguments. The process applies to MSTest, NUnit, and xUnit.net projects to enable unified test execution across the solution.

Does the Microsoft Testing Platform migration support xUnit.net projects?

Yes, the MTP migration supports xUnit.net projects. It handles xUnit.net v3 natively and xUnit.net v2 via the YTest.MTP.XUnit2 extension, alongside MSTest and NUnit, ensuring a smooth transition of test execution to MTP.

How do I translate dotnet test CLI arguments when transitioning to Microsoft Testing Platform?

Translating dotnet test CLI arguments for Microsoft Testing Platform requires mapping existing VSTest command-line inputs to MTP equivalents. The migration addresses these translations alongside CI/CD pipeline updates to ensure test execution works seamlessly with the new runner.

What CI/CD pipeline updates are needed when switching to the Microsoft Testing Platform runner?

Switching to the Microsoft Testing Platform runner requires updating CI/CD pipelines to invoke MTP-based testing instead of VSTest. This involves adjusting pipeline scripts and configurations to align with the new unified test runner and translated CLI arguments.

Can I configure Directory.Build.props and global.json for Microsoft Testing Platform migration?

Yes, configuring Directory.Build.props and global.json is a core part of the MTP migration. These configuration files are updated to enable the MTP runner across the entire .NET solution, applying the unified test execution settings consistently.

What migration pitfalls should I anticipate when moving test execution to Microsoft Testing Platform?

When moving test execution to Microsoft Testing Platform, anticipate pitfalls related to test discovery and filtering. The migration addresses these specific challenges to help teams transition from VSTest with minimal disruption to existing workflows.