maui-doctor

Diagnose MAUI development environment issues and apply automated remediation.

186|19|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/Redth/MAUI.Sherpa --skill maui-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-doctor
Source: https://github.com/Redth/MAUI.Sherpa/tree/main/src/MauiSherpa/Resources/Raw/Skills/maui-doctor
Command: npx skills add https://github.com/Redth/MAUI.Sherpa --skill maui-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Maui Doctor skill automatically diagnoses and fixes issues in a MAUI development environment, reducing time spent on setup and troubleshooting.

Core Features & Use Cases

  • Environment validation: verifies SDKs, workloads, JDK, Android SDK, and platform tools across macOS, Windows, and Linux.
  • Autonomous remediation: applies recommended fixes and re-validates until all checks pass.
  • Real-world scenario: after updating the SDKs, run Maui Doctor to detect mismatches and re-align toolchains with minimal manual intervention.

Quick Start

Run maui-doctor to diagnose and repair your MAUI environment. After each fix, Maui Doctor re-validates automatically. If prompted, review actions and confirm to continue.

Frequently Asked Questions about maui-doctor

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

FAQPage Schema
How do I diagnose and fix .NET MAUI workload issues after an SDK update?

To diagnose .NET MAUI workload issues, you can run a validation check that detects SDK mismatches and re-aligns toolchains. It automatically verifies .NET SDKs, MAUI workloads, and platform tools, applying recommended fixes and re-validating until all checks pass.

What is the best way to validate Microsoft OpenJDK and Android SDK for MAUI development?

Validating Microsoft OpenJDK and the Android SDK for MAUI involves checking your environment against dynamically discovered NuGet workload manifests. This process enforces official Android tools and Microsoft OpenJDK, ensuring your cross-platform setup on Windows, macOS, or Linux is correct.

Does MAUI environment diagnostics support macOS, Windows, and Linux toolchains?

Yes, MAUI environment diagnostics supports macOS, Windows, and Linux toolchains. It validates the required SDKs, JDK, and platform-specific tools across all three operating systems to ensure your MAUI development environment is fully configured.

How do I automatically repair MAUI development environment setup errors?

To automatically repair MAUI development environment setup errors, you can use an autonomous remediation process. It applies fixes for detected SDK, JDK, or workload issues and then re-validates the environment automatically, minimizing manual intervention.

Why does my MAUI build fail due to toolchain mismatches and how can I resolve it?

MAUI build failures from toolchain mismatches occur when local SDKs and workloads fall out of sync. You can resolve this by running an environment diagnostic that discovers requirements from NuGet workload manifests and re-aligns your toolchains.