skills.rest
dotnet
dotnetOFFICIAL
Explore all skills by this author →
Website𝕏@dotnetfdnGitHub

dotnet-maui-doctor

Diagnose and fix .NET MAUI environment configuration issues across platforms.

5.1k|377|Updated Feb 3, 2026
Search Tags:#environment setup#xcode#dotnet maui#sdk diagnostics#workload installation#android sdk#java jdk
One-click install
npx skills add https://github.com/dotnet/skills --skill dotnet-maui-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dotnet-maui-doctor
Source: https://github.com/dotnet/skills/tree/main/plugins/dotnet-maui/skills/dotnet-maui-doctor
Command: npx skills add https://github.com/dotnet/skills --skill dotnet-maui-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automatically diagnoses and fixes common issues within a .NET MAUI development environment, ensuring your setup is ready for building cross-platform applications.

Core Features & Use Cases

  • Environment Validation: Checks for correct installations and configurations of .NET SDK, MAUI workloads, Java JDK, Android SDK, Xcode, and Windows SDK.
  • Automated Remediation: Attempts to fix detected issues, such as installing missing workloads or SDK components.
  • Dynamic Requirements: Discovers version requirements dynamically from NuGet, avoiding hardcoded dependencies.
  • Use Case: When you encounter build errors like "Android SDK not found" or "Java version errors" after setting up .NET MAUI, this Skill can automatically identify and resolve the underlying environment problems.

Quick Start

Run the dotnet-maui-doctor skill to check and fix my .NET MAUI development environment.

Frequently Asked Questions about dotnet-maui-doctor

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

FAQPage Schema
How do I fix .NET MAUI build errors related to missing Android SDK or Java JDK?▼

To fix .NET MAUI build errors, you can diagnose your environment to validate .NET SDK, MAUI workloads, Java JDK, and Android SDK versions. Automated remediation installs missing components and re-validates the setup to resolve underlying configuration problems.

What is the best way to check if my Xcode and Windows SDK versions are compatible with .NET MAUI?▼

The best way to check compatibility is to run a diagnostic that validates Xcode and Windows SDK versions against dynamic requirements sourced from NuGet. This avoids hardcoded dependencies and ensures your local setup meets the current .NET MAUI standards.

How do I automatically install missing .NET MAUI workloads on macOS or Windows?▼

You can automatically install missing .NET MAUI workloads by running an environment diagnostic tool. It detects absent workloads, automates the installation process, and re-validates the environment to ensure the configuration is fully corrected.

Does .NET MAUI environment validation support Microsoft OpenJDK across Linux, macOS, and Windows?▼

Yes, .NET MAUI environment validation supports macOS, Windows, and Linux. It specifically checks for the correct installation and configuration of the Java JDK, with validation explicitly requiring the Microsoft OpenJDK distribution.

Why does my .NET MAUI setup fail after installing the SDK, and how can I resolve it?▼

Your .NET MAUI setup fails when specific SDK components or workloads are missing or incorrectly configured. You can resolve this by running an automated diagnostic that discovers version requirements dynamically and fixes the detected environment issues.

Can I dynamically check .NET MAUI SDK requirements without hardcoding version numbers?▼

Yes, you can dynamically check .NET MAUI SDK requirements by using a diagnostic tool that sources version requirements directly from NuGet. This approach verifies your .NET SDK, MAUI workloads, and platform SDKs without relying on hardcoded dependencies.

Related Skills

Explore More Software Engineering Skills→
dbowm91dbowm91

upgrade

Query GitHub releases and execute installer scripts to update the codegg agent.

Community
Intermediate
managedcodemanagedcode
466

dotnet-maui

Build cross-platform .NET MAUI applications with MVVM and native packaging.

Official
Advanced
umbrella-librariesumbrella-libraries
8

nuget-safe-upgrade

Upgrade NuGet packages across multi-targeted .NET projects with exclusions and build verification.

Official
Advanced
ojrojasojrojas

dotnet-maui-doctor

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

Community
Advanced