What is dotnet-maui-doctor?

A troubleshooting guide for setting up and checking the tools needed to build .NET MAUI apps, including the .NET SDK, Java, Android, Apple, and Windows components.

Use it when setting up MAUI or diagnosing errors about missing SDKs, workloads, Java, Android tools, Xcode, or Windows SDKs.

It helps find missing or incompatible development tools when a MAUI project will not build or the environment has changed.

dotnet-maui-doctor — Skill for Claude Code and Codex by managedcode: A troubleshooting guide for setting up and checking the…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/managedcode/dotnet-skills/dotnet-maui-doctor

Any agent

npx skills add managedcode/dotnet-skills --skill dotnet-maui-doctor

Clone the repo

git clone --depth 1 https://github.com/managedcode/dotnet-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/managedcode/dotnet-skills/dotnet-maui-doctor.svg)](https://agentmods.dev/skills/managedcode/dotnet-skills/dotnet-maui-doctor)

Your own site

<a href="https://agentmods.dev/skills/managedcode/dotnet-skills/dotnet-maui-doctor"><img src="https://agentmods.dev/badge/skills/managedcode/dotnet-skills/dotnet-maui-doctor.svg" alt="Measured on agentmods" height="20"></a>

Per session 150 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 2,303 The whole file, excluding the scripts and references it only reads on demand.

Security scan D 3 findings. Scan, not verified.

Origin 100% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00150	$0.02303
Opus 5	$0.00075	$0.01151
Sonnet 5	$0.00030	$0.00461
Haiku 4.5	$0.00015	$0.00230

Measured 6d ago against content hash ba8262439bdb, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade D, and why

dotnet-maui-doctor scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- Admin/sudo access may be required for installing SDKs and workloads

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf "$TEMP_DIR"

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Bash prerequisites**: `curl`, `jq`, and `unzip` (macOS/Linux)

Origin

This is a copy

100% identical to dotnet-maui-doctor — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

catalog/Frameworks/Official-DotNet-MAUI/skills/dotnet-maui-doctor/SKILL.md · 208 lines

How it starts

The opening of the file, as written. The whole thing — 208 lines — stays where its author put it; the contents beside it link to each section on GitHub.

.NET MAUI Doctor

Validate and fix .NET MAUI development environments. All version requirements are discovered dynamically from NuGet APIs — never hardcode versions.

When to Use

Setting up a new .NET MAUI development environment
Build errors mentioning missing SDKs, workloads, JDK, or Android components
Errors like "Android SDK not found", "Java version", or "Xcode not found"
Verifying environment health after SDK or OS updates

When Not to Use

Non-MAUI .NET projects (use standard .NET SDK troubleshooting instead)
Xamarin.Forms apps (different toolchain and workload requirements)
Runtime app crashes unrelated to environment setup
App store publishing or signing issues
IDE-specific issues (Visual Studio or VS Code configuration)

Important: .NET Version Currency

Your training data may be outdated regarding .NET versions. .NET ships new major releases annually (November). Always check the releases-index.json (Task 2) to discover the latest active major release — do not assume your training data reflects the current version. For example, if you know about .NET 9.0 but the releases index shows .NET 10.0 as active, use .NET 10.0.

Inputs

A development machine running macOS, Windows, or Linux
Shell access (Bash on macOS/Linux, PowerShell on Windows)
Internet access for NuGet API queries and SDK downloads
Admin/sudo access may be required for installing SDKs and workloads
Bash prerequisites: curl, jq, and unzip (macOS/Linux)
PowerShell prerequisites: Invoke-RestMethod and System.IO.Compression (built-in on Windows)

Behavior

Run through ALL tasks autonomously
Re-validate after each fix
Iterate until complete or no further actions possible
After detecting platform (Task 1), load only the matching platform-specific references

Workflow

Task 1: Detect Environment

# macOS
sw_vers && uname -m

# Windows
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"

# Linux
cat /etc/os-release && uname -m

Read the full file on GitHub · 208 lines

Files

What ships with it

12 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

6d ago First seen · 208 lines · 150 tokens per session scan D ba8262439bdb

Subscribe to this mod's changes

dotnet-maui-doctor is a skill published in the GitHub repository managedcode/dotnet-skills (477 stars, last pushed yesterday), licensed MIT. It adds 150 tokens to every session and 2,303 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it D with 3 findings (asks for root, recursive force delete, makes network calls). It is 100% identical to dotnet-maui-doctor, differing in 0 lines, and is treated as a copy.

Debugging Mobile claude-code codex copilot dotnet dotnet-skills skills

xamarin-maui-syncfusion-migration

Companion migration skill for converting Syncfusion Xamarin.Forms controls to .NET MAUI using control-specific mapping guidance.

syncfusion/xamarin-maui-migration-skills · 31 tokens

xamarin-maui-framework-migration

Baseline migration skill for moving Xamarin.Forms solutions or copied modules to .NET MAUI using a create-new-project workflow.

syncfusion/xamarin-maui-migration-skills · 31 tokens

xamarin-maui-platform-specific-migration

Companion migration skill for Android, iOS, and Windows platform-specific tasks when moving Xamarin.Forms code to .NET MAUI.

syncfusion/xamarin-maui-migration-skills · 35 tokens

xamarin-maui-renderer-handler-migration

Companion migration skill for converting Xamarin.Forms custom renderers and effects to .NET MAUI handlers.

syncfusion/xamarin-maui-migration-skills · 30 tokens

wear-compose-m3

Expert guidance for working with Wear OS Compose Material3. Use this skill when creating, updating, or migrating Wear OS projects. This includes the androidx.wear.compose.material3, androidx.wear.compose.foundation, and androidx.wear.compose.navigation3 libraries. Also working with core components such as AppScaffold…

android/skills · 101 tokens

leanback-to-compose-tv-migration

Provides instructions and architectural patterns for migrating Android TV applications from legacy Leanback UI Toolkit, Android Views, or Support Fragments to Jetpack Compose for TV (androidx.tv). Use this skill for Leanback to Compose migrations, including browse screen, settings screen, authentication screen, login…

android/skills · 151 tokens

dotnet-maui-doctor