Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

README.md

Agent Skills

Distributable agent skills for .NET MAUI development. Installable via the Copilot CLI, Claude Code, or VS Code plugin system.

Plugins

Plugin Purpose
dotnet-maui Default app-development plugin for building production .NET MAUI apps.
dotnet-maui-tooling Specialist tooling plugin for DevFlow automation, Java/Kotlin and slim bindings, workload discovery, and diagnostics.

DevFlow runtime skills (maui-devflow-onboard, maui-devflow-debug, maui-devflow-session-review) live in plugins/dotnet-maui-tooling/skills/, are bundled with the maui CLI by maui devflow init, and are exposed through the plugin manifest.

Installation

# Add this repo as a marketplace
/plugin marketplace add dotnet/maui-labs

# Install app-development skills
/plugin install dotnet-maui@dotnet-maui-labs

# Install specialist tooling skills
/plugin install dotnet-maui-tooling@dotnet-maui-labs

dotnet-maui skills

Area Skill Description
App fundamentals maui-app-architecture Structure MAUI apps with DI, MVVM, Shell routing, compiled bindings, and trim-safe navigation.
App fundamentals maui-current-apis Give target-framework-aware guidance for current MAUI APIs and avoid Xamarin.Forms-era suggestions.
App fundamentals maui-project-structure Organize single-project resources, app metadata, Central Package Management, fonts, images, and assets.
App fundamentals maui-ui-patterns Build robust layouts, typed templates, command binding, state handling, and automation-friendly UI.
App fundamentals maui-accessibility Add semantic labels, hints, headings, focus behavior, screen-reader announcements, and accessibility test hooks.
App fundamentals maui-performance Improve startup, scrolling, compiled bindings, image sizing, Release-mode measurement, trimming, and NativeAOT safety.
App fundamentals maui-unit-testing Make ViewModels and services testable with fake platform abstractions and clear device/integration boundaries.
App features maui-app-assets-lifecycle Manage app icons, splash screens, packaged files, fonts, images, lifecycle events, and state restore.
App features maui-aspire-client Connect MAUI clients to Aspire-hosted services with service discovery, device fallbacks, certificates, and debug cleartext.
App features maui-auth-secure-storage Implement WebAuthenticator and MSAL flows, callback URIs, token storage, logout cleanup, and Blazor Hybrid auth handoff.
App features maui-blazor-hybrid Configure BlazorWebView and HybridWebView, static assets, JS/.NET messaging, trim-safe JSON, and DevFlow CDP debugging.
App features maui-device-capabilities Use camera, media picker, file picker, geolocation, maps, contacts, permissions, and platform declarations.
App features maui-localization-theming Implement RESX localization, culture switching, RTL layout, platform metadata, AppThemeBinding, and runtime themes.
App features maui-networking-offline-data Build typed HttpClient flows, emulator/device networking, retries, cancellation, SQLite/offline sync, and encryption decisions.
App features maui-notifications-deep-links Add local and push notifications, FCM/APNs/Azure Notification Hubs, app links, universal links, URI schemes, and permission UX.
Advanced and migration maui-ai-tool-bindings Create source-generated Microsoft.Extensions.AI tool bindings with DI-bound parameters, approvals, and per-session scope.
Advanced and migration maui-controls-deep-dive Tune CollectionView, SafeAreaEdges, GraphicsView, gestures, animations, and control-specific semantics.
Advanced and migration maui-custom-handlers Customize handlers with mappers, platform partials, custom handler structure, and renderer-to-handler migration.
Advanced and migration maui-essentials-ai Use Microsoft.Maui.Essentials.AI, Apple Intelligence chat, local embeddings, local tool invocation, and fallback UX.
Advanced and migration maui-labs-platform-targeting Target MAUI Labs GTK4, AppKit, and WPF platforms with project setup and conditional guidance.
Advanced and migration maui-platform-invoke Wrap native platform APIs behind DI services, permissions, platform metadata, partial platform files, and lifecycle hooks.
Advanced and migration maui-release-notes Convert official .NET/MAUI release notes into app upgrade notes, CI changes, requirements, and validation plans.
Advanced and migration xamarin-forms-migration Audit Xamarin.Forms apps, replace namespaces/APIs, migrate DependencyService and MessagingCenter usage, and plan parity work.

dotnet-maui-tooling skills

Skill Description
maui-devflow-onboard Add MAUI DevFlow packages and app registration to a project.
maui-devflow-debug Run MAUI DevFlow build, deploy, connection recovery, inspect, and fix loops.
maui-devflow-session-review Review opt-in MAUI DevFlow sessions for friction, retries, workarounds, and product feedback.
devflow-automation Automate MAUI app inspection and debugging workflows through DevFlow tools.
devflow-connect Diagnose and fix DevFlow agent connectivity issues between the maui CLI and running .NET MAUI apps.
maui-ai-debugging Legacy compatibility skill for older DevFlow clients.
android-java-bindings Write direct Java/Kotlin C# bindings and diagnose missing APIs, metadata, interface contracts, and generator errors.
android-slim-bindings Create Android slim bindings using the Native Library Interop approach.
ios-slim-bindings Create iOS slim bindings using the Native Library Interop approach.
dotnet-workload-info Discover installed .NET workloads, SDK versions, and dependency requirements.

Adding Skills

See CONTRIBUTING.md for the full guide. Quick summary:

  1. Create plugins/<plugin>/skills/<skill-name>/SKILL.md with YAML frontmatter
  2. Create tests/<plugin>/<skill-name>/eval.yaml with evaluation scenarios
  3. Submit a PR -- the skill-check workflow validates automatically
  4. A maintainer posts /evaluate to run LLM-based evaluation