dotnet-maui-doctor

Diagnose and fix .NET MAUI environment issues across macOS, Windows, and Linux.

2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/sayedihashimi/copilot-skill-eval --skill dotnet-maui-doctor-sayedihashimi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-maui-doctor
Source: https://github.com/sayedihashimi/copilot-skill-eval/tree/main/examples/aspnet-razor-pages/plugins/dotnet-skills/dotnet-maui/skills/dotnet-maui-doctor
Command: npx skills add https://github.com/sayedihashimi/copilot-skill-eval --skill dotnet-maui-doctor-sayedihashimi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

MAUI development environments can be tricky to set up and keep healthy across platforms. This skill automates detection of version mismatches and configuration gaps for .NET MAUI SDKs, workloads, JDK (Microsoft OpenJDK), Android SDK, Xcode, and Windows SDK, and provides actionable remediation guidance.

Core Features & Use Cases

  • Auto-detects and validates platform prerequisites using live manifest data from NuGet (WorkloadDependencies.json).
  • Verifies .NET MAUI SDKs, workloads, and platform toolchains (JDK, Android SDK, Xcode, Windows SDK) across macOS, Windows, and Linux.
  • Guides remediation commands and re-validates until all checks pass.
  • Use Case: setting up a new MAUI workstation, post-update verification, or troubleshooting build failures that mention missing SDKs or tools.

Quick Start

Run the dotnet-maui-doctor skill to scan your environment and receive guided remediation steps.

Frequently Asked Questions about dotnet-maui-doctor

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

FAQPage Schema
How do I diagnose .NET MAUI environment setup issues across macOS, Windows, and Linux?

To diagnose .NET MAUI environment issues, run a health check that validates SDKs, JDK (Microsoft OpenJDK), Android SDK, Xcode, and Windows SDK. It detects version mismatches and configuration gaps using live manifest data from NuGet, then provides actionable remediation steps.

Why does my .NET MAUI build fail after a workload update due to missing SDKs or tools?

Your .NET MAUI build may fail due to version mismatches in JDK, Android SDK, Xcode, or Windows SDK after updates. A post-update verification scan detects these mismatches using dynamic version discovery from NuGet WorkloadDependencies.json and recommends explicit versioned installs to fix the issue.

What is the best way to validate Xcode and JDK prerequisites for .NET MAUI development?

The best way to validate Xcode and JDK prerequisites for .NET MAUI is to scan your environment against live manifest data from NuGet WorkloadDependencies.json. This process verifies platform toolchains, enforces dynamic version discovery, and guides you through remediation commands until all checks pass.

Can I fix .NET MAUI SDK version mismatches and configuration gaps automatically?

You can fix .NET MAUI SDK version mismatches and configuration gaps by running a diagnostic health check. It auto-detects missing tools across macOS, Windows, and Linux, recommends explicit versioned installs for remediation, and re-validates your environment until all prerequisite checks pass.

Does .NET MAUI doctor support troubleshooting Microsoft OpenJDK and Android SDK configuration?

Yes, .NET MAUI diagnostic checks support troubleshooting Microsoft OpenJDK and Android SDK configurations. It validates these platform toolchains during setup and health checks across macOS, Windows, and Linux, detecting version mismatches and providing guided remediation commands to restore your environment.

When do I need to run a .NET MAUI environment health check?

You need to run a .NET MAUI environment health check when setting up a new workstation, after applying SDK or workload updates, or when troubleshooting build failures that mention missing SDKs or tools. It validates .NET MAUI SDKs, JDK, Android SDK, Xcode, and Windows SDK configurations.