maui-labs: Skill for Claude Code

DevFlow Onboard

Use this skill to add MAUI DevFlow to a project after maui devflow init has installed the DevFlow skills.

When to Use

• The project has no Microsoft.Maui.DevFlow.* package references yet.
• The user asks how to onboard, initialize, install, integrate, or set up DevFlow.
• The agent needs to choose between standard, Blazor, GTK, or GTK + Blazor DevFlow packages.
• The repo uses Central Package Management and package edits need to be split correctly.
• maui devflow init has installed skills and the user asks for the next project edits.

Route Elsewhere

• If package references and AddMauiDevFlowAgent() are already present but the CLI cannot connect, use maui-devflow-debug.
• If an agent is reachable and the user wants to inspect, tap, screenshot, or debug UI, use maui-devflow-debug.

Workflow

1. Optionally run maui devflow skills check and update bundled skills before editing if it reports update-available-from-current-cli.

2. Find MAUI app projects in the workspace. Prefer app projects with UseMaui, platform TFMs such as net*-android/net*-ios/net*-maccatalyst/net*-windows, or GTK MAUI package references.

3. Determine whether each target project is standard MAUI, MAUI + Blazor WebView, GTK, or GTK + Blazor.

4. Add the correct DevFlow package references. Respect Central Package Management if Directory.Packages.props is present.

5. Register DevFlow in MauiProgram.cs inside #if DEBUG.

6. Build and run the app.

7. Verify with:

   maui devflow diagnose
   maui devflow wait
   maui devflow ui tree --depth 1
   

If verification fails after integration, switch to maui-devflow-debug for connectivity recovery.

Stop Signals

• Stop before editing if multiple MAUI app projects exist and the user has not indicated which one to onboard.
• Stop and ask before enabling DevFlow outside Debug builds.
• Stop after package/registration edits and verify with a build before doing runtime debugging.

Critical Anti-patterns