skills.rest
dotnet
dotnetOFFICIAL
Explore all skills by this author →
Website𝕏@dotnetfdnGitHub

maui-ai-debugging

Debug .NET MAUI and Blazor Hybrid apps via terminal-driven DevFlow workflows.

209|27|Updated Mar 10, 2026
Search Tags:#automation#cdp#devflow#ui debugging#maui#blazor hybrid#android emulator
One-click install
npx skills add https://github.com/dotnet/maui-labs --skill maui-ai-debugging-dotnet
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maui-ai-debugging
Source: https://github.com/dotnet/maui-labs/tree/main/plugins/dotnet-maui/skills/maui-ai-debugging
Command: npx skills add https://github.com/dotnet/maui-labs --skill maui-ai-debugging-dotnet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It eliminates the time-consuming cycle of guessing what’s wrong in a .NET MAUI or MAUI Blazor Hybrid app by giving you a terminal-driven build → deploy → inspect → fix loop with runtime UI and WebView debugging.

Core Features & Use Cases

  • Build and deploy orchestration: Runs the typical MAUI app launch flow and waits for the connected DevFlow agent so you can reliably start inspecting runtime state.
  • Runtime UI inspection and interaction: Uses visual tree inspection, element querying, screenshots, property reads, live property edits, and UI actions to validate fixes quickly.
  • Blazor WebView CDP debugging: Captures accessible DOM snapshots and evaluates JavaScript to diagnose WebView-side issues in Blazor Hybrid apps.
  • Diagnostics and reliability loops: Provides health checks, log retrieval, and troubleshooting guidance for common connection, build, and platform setup failures (Android/iOS/macOS/Mac Catalyst/Linux).
  • When to use: Designed as a legacy end-to-end workflow for older clients, older DevFlow setups, and compatibility with the older maui-ai-debugging naming.

Quick Start

Ask your AI to run the legacy MAUI DevFlow loop by launching the app, then waiting for the agent with maui devflow wait so the skill can inspect the UI and guide your next fix.

Frequently Asked Questions about maui-ai-debugging

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

FAQPage Schema
How do I debug a MAUI Blazor Hybrid app end-to-end from the terminal?▼

Debug MAUI Blazor Hybrid apps end-to-end using a terminal-driven build, deploy, and inspect loop. The workflow launches the app, waits for the DevFlow agent readiness, and then captures DOM snapshots to evaluate JavaScript and diagnose WebView-side issues.

Can I inspect the runtime UI tree and interact with elements in a .NET MAUI app?▼

Yes, runtime UI inspection in .NET MAUI supports visual tree inspection, element querying, screenshots, property reads, and live property edits. You can validate fixes quickly by applying UI actions directly on iOS simulators, Android emulators, macOS, and Linux/GTK.

Does MAUI debugging work across iOS simulators, Android emulators, and macOS?▼

MAUI debugging supports iOS simulators, Android emulators, macOS/macCatalyst, and Linux/GTK platforms. It orchestrates the typical app launch flow and provides health checks with troubleshooting guidance for common platform-specific connection and build setup failures.

What's the best way to troubleshoot connection and build failures during MAUI deployment?▼

Troubleshoot MAUI deployment failures using built-in diagnostics and health checks. The workflow retrieves logs and provides targeted troubleshooting guidance for common connection, build, and platform setup failures across Android, iOS, macOS, Mac Catalyst, and Linux.

Do I need the DevFlow CLI to inspect MAUI app properties and network logs?▼

Yes, DevFlow CLI and NuGet-based agent integration are required to inspect MAUI app properties and network logs. The workflow uses the 'maui devflow wait' command to ensure agent readiness before executing UI tree, screenshot, property, log, and sensor inspection commands.

Why is my MAUI DevFlow agent not connecting during the debugging loop?▼

If the MAUI DevFlow agent is not connecting, use the workflow's health checks and log retrieval to diagnose the issue. It provides specific troubleshooting guidance for common connection failures, build errors, and platform setup problems across Android, iOS, macOS, and Linux.

Related Skills

Explore More Software Engineering Skills→
aritchiearitchie
3

maui-devflow-debug

Automate build, deploy, inspect, and fix cycles for MAUI apps with DevFlow.

Community
Advanced
dotnetdotnet
209

maui-devflow-debug

Build, deploy, and inspect .NET MAUI apps via DevFlow for runtime debugging.

Official
Advanced
mintuzmintuz
21

debug

Diagnose iOS simulator issues and validate fixes with XcodeBuildMCP.

Community
Advanced
dotnetdotnet
209

maui-devflow-onboard

Onboard MAUI DevFlow by aligning packages and MauiProgram.cs registration.

Official
Intermediate