dotnet-maui-doctor

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

Updated May 28, 2026
One-click install
npx skills add https://github.com/ojrojas/AgentsInstructions --skill dotnet-maui-doctor-ojrojas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-maui-doctor
Source: https://github.com/ojrojas/AgentsInstructions/tree/main/.claude/skills/dotnet-maui/skills/dotnet-maui-doctor
Command: npx skills add https://github.com/ojrojas/AgentsInstructions --skill dotnet-maui-doctor-ojrojas

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses common issues in the .NET MAUI development environment, ensuring a smooth setup and troubleshooting process.

Core Features & Use Cases

  • Environment Validation: Checks .NET SDK, workloads, Java JDK, Android SDK, Xcode, and Windows SDK versions.
  • Dynamic Version Discovery: Automatically determines the latest compatible versions from NuGet WorkloadDependencies.json.
  • Platform-Specific Support: Offers tailored instructions for macOS, Windows, and Linux.
  • Use Case: When encountering build errors, missing SDKs, or other environment-related issues in .NET MAUI projects.

Quick Start

Run the dotnet-maui-doctor skill to diagnose and fix your .NET MAUI development environment issues.

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 build errors related to missing SDKs?

To diagnose .NET MAUI build errors from missing SDKs, run an environment validation check that scans your .NET SDK, workloads, Java JDK, Android SDK, Xcode, and Windows SDK installations to identify version mismatches or absent components.

What is the best way to validate my .NET MAUI development environment on macOS and Windows?

The best way to validate your .NET MAUI development environment on macOS and Windows is to use a diagnostic tool that dynamically checks your installed SDKs against the latest compatible versions from NuGet WorkloadDependencies.json.

Why does my .NET MAUI Android project fail to build due to Java JDK or Android SDK issues?

Your .NET MAUI Android project fails to build due to Java JDK or Android SDK issues when your installed versions do not match the dynamically discovered compatible versions required by the .NET MAUI workloads.

How does dynamic version discovery work for .NET MAUI workload dependencies?

Dynamic version discovery for .NET MAUI workload dependencies works by automatically fetching and comparing the latest compatible SDK versions from NuGet WorkloadDependencies.json against your local environment setup.

Can I troubleshoot .NET MAUI environment issues on Linux?

Yes, you can troubleshoot .NET MAUI environment issues on Linux, as the diagnostic process offers tailored validation instructions and fixes for macOS, Windows, and Linux platforms.