skills.rest
1k-off
1k-offCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

dotnet-maui-doctor

Diagnose and fix .NET MAUI environment issues across SDKs, workloads, and tooling.

1|Updated May 21, 2026
Search Tags:#dotnet maui#android sdk#environment diagnosis#microsoft openjdk#workload validation#xcode troubleshooting#build prerequisites
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill dotnet-maui-doctor-1k-off
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dotnet-maui-doctor
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/dotnet-maui-doctor
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill dotnet-maui-doctor-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It diagnoses and resolves broken or missing .NET MAUI development prerequisites such as .NET SDKs, MAUI workloads, Microsoft OpenJDK, Android SDK components, and macOS/Windows platform requirements.

Core Features & Use Cases

  • Environment diagnosis: Detects the user’s OS and verifies installed SDKs, workloads, and platform tools.
  • Live requirement discovery: Determines the required versions dynamically from NuGet WorkloadDependencies.json and dotnet release metadata (no hardcoded version assumptions).
  • Targeted remediation and re-validation: Applies the correct fixes for missing/mismatched components and re-runs checks until the environment is healthy.
  • Use Case: When you hit MAUI build errors like “Android SDK not found” or “workloads must be installed,” it identifies exactly what’s missing and guides the minimal set of fixes for your platform.

Quick Start

Ask the agent to run dotnet-maui-doctor to diagnose your current .NET MAUI environment and fix any missing SDK/workload/JDK/Android components on your operating system.

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 when the Android SDK is not found?▼

Fix .NET MAUI build failures by validating the .NET SDK, MAUI workloads, and Microsoft OpenJDK installations. The diagnostic process identifies missing Android SDK components and guides the minimal platform-specific fixes required to resolve the error.

Why does my .NET MAUI workload validation fail after an SDK update?▼

.NET MAUI workload validation fails after updates due to mismatched versions between the SDK and installed workloads. Dynamic version discovery reads NuGet WorkloadDependencies.json to identify exact requirements and iteratively re-validates the environment until all mismatches are resolved.

Do I need Microsoft OpenJDK to build .NET MAUI apps on macOS and Windows?▼

Yes, building .NET MAUI apps requires Microsoft OpenJDK. The diagnostic process enforces Microsoft OpenJDK-only rules, verifying your installation meets the dynamically discovered requirements from NuGet metadata before proceeding with workload validation.

What's the best way to diagnose missing .NET MAUI build prerequisites on Linux?▼

To diagnose missing .NET MAUI prerequisites on Linux, run an environment validation check focused on Android SDK components. It detects your OS, verifies installed workloads against dynamically discovered dotnet release metadata, and guides targeted remediation for missing tooling.

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

Dynamic version discovery for .NET MAUI workloads reads NuGet WorkloadDependencies.json and dotnet release metadata to determine exact required versions. This avoids hardcoded assumptions, ensuring accurate validation of your installed SDKs and platform tooling components.

Can I use .NET MAUI environment diagnosis to fix Xcode troubleshooting issues on macOS?▼

Yes, .NET MAUI environment diagnosis covers Xcode troubleshooting on macOS by validating required platform tooling alongside the .NET SDK and MAUI workloads. It detects missing macOS platform requirements and applies targeted fixes to resolve build prerequisites.

Related Skills

Explore More Software Engineering Skills→
rjmurillorjmurillo
24

moq-analyzers-build-and-env

Automate .NET SDK installation, build, and test runs for Moq.Analyzers projects.

Community
Advanced
linuxdevellinuxdevel
27

avalonia-deployment

Package and deploy Avalonia apps across multiple OS targets with dotnet publish.

Community
Intermediate
dotnetdotnet
5.1k

dotnet-maui-doctor

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

Official
Advanced
briannadoubtbriannadoubt

swift-wasm

Install and validate the Swift 6.2 WASM toolchain for WebAssembly targets.

Community
Advanced