skills.rest
D1ssolve
D1ssolveCOMMUNITY
Explore all skills by this author →
GitHub

dotnet-maui-doctor

Diagnoses and fixes .NET MAUI development environment issues across macOS, Windows, and Linux.

1|Updated Jun 1, 2026
Search Tags:#troubleshooting#diagnostics#environment setup#dotnet maui#workloads#android sdk#openjdk
One-click install
npx skills add https://github.com/D1ssolve/craft-agents --skill dotnet-maui-doctor-d1ssolve
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dotnet-maui-doctor
Source: https://github.com/D1ssolve/craft-agents/tree/main/skills/dotnet-maui-doctor
Command: npx skills add https://github.com/D1ssolve/craft-agents --skill dotnet-maui-doctor-d1ssolve

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a .NET MAUI development environment involves many moving parts — the .NET SDK, MAUI workloads, Microsoft OpenJDK, Android SDK, Xcode, and Windows SDK — and version mismatches or missing components cause cryptic build errors. This Skill validates every component, discovers correct versions dynamically from NuGet APIs, and applies fixes until the environment builds successfully. ## Core Features & Use Cases - Full environment validation: Checks .NET SDK against active releases, verifies MAUI workloads, Microsoft OpenJDK, Android SDK packages, Xcode (macOS), and Windows SDK. - Dynamic version discovery: Queries NuGet WorkloadDependencies.json for authoritative JDK, Android SDK, and Xcode version requirements instead of relying on hardcoded or stale values. - Guided remediation: Installs workloads with explicit versions, configures Android SDK via sdkmanager, and re-validates after each fix, ending with a test project build. - Use Case: After upgrading to a new .NET release, your MAUI project fails with "Android SDK not found" — run this Skill to detect the outdated workload, discover the required Android API level, install missing packages, and verify with a clean build. ## Quick Start Check my .NET MAUI development environment for problems and fix anything that is misconfigured or missing.

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 environment setup errors?▼

Run a full environment validation that checks the .NET SDK, MAUI workloads, Microsoft OpenJDK, Android SDK, and Xcode. This Skill detects each issue, discovers correct versions from NuGet APIs, applies fixes, and re-validates until a test project builds successfully.

How to check which .NET MAUI workloads are installed?▼

Run dotnet workload list to see installed workloads. Required workloads are maui (or maui-android on Linux), android, and ios on macOS. Always install or reinstall workloads with an explicit --version flag rather than using workload update or repair.

Which JDK does .NET MAUI require for Android development?▼

Only Microsoft Build of OpenJDK is supported for .NET MAUI Android development. Verify by running java -version and confirming the output contains Microsoft. JAVA_HOME is not required because MAUI tooling auto-detects Microsoft OpenJDK from known install paths.

Why does my MAUI build fail with Android SDK not found?▼

The Android SDK is missing, not on a known path, or lacks required packages like platform-tools, build-tools, or the target platform. Install missing packages with sdkmanager using the versions from WorkloadDependencies.json, then accept licenses.

Can I use .NET MAUI on Linux?▼

Linux supports Android targets only. Use the maui-android workload instead of the maui meta-workload, which includes iOS and Mac dependencies that cannot install on Linux. iOS, Mac Catalyst, and Windows targets require macOS or Windows respectively.

When should I not use this MAUI environment diagnostic?▼

Do not use it for non-MAUI .NET projects, Xamarin.Forms apps, runtime app crashes unrelated to environment setup, app store publishing or signing issues, or IDE-specific configuration problems in Visual Studio or VS Code.

Related Skills

Explore More Software Engineering Skills→
jleechanorgjleechanorg

gif-search

Search and download GIFs from Tenor using curl and jq.

Official
Intermediate
davidortinaudavidortinau
28

maui-ai-debugging

Build, deploy, inspect, and debug .NET MAUI and MAUI Blazor Hybrid applications.

Community
Advanced
dotnetdotnet
209

dotnet-workload-info

Query live NuGet and release metadata APIs for .NET SDK and workload versions.

Official
Intermediate
RedthRedth
186

maui-doctor

Diagnose MAUI development environment issues and apply automated remediation.

Community
Advanced