Skip to content

[RFC] Customer-facing Copilot skills plugin (46 skills + builder agent)#34429

Draft
jfversluis wants to merge 1 commit intomainfrom
feature/copilot-skills-plugin
Draft

[RFC] Customer-facing Copilot skills plugin (46 skills + builder agent)#34429
jfversluis wants to merge 1 commit intomainfrom
feature/copilot-skills-plugin

Conversation

@jfversluis
Copy link
Member

@jfversluis jfversluis commented Mar 11, 2026

Important

This is an RFC / idea exploration — not a final proposal. The goal is to start a conversation about whether the .NET MAUI repo should ship customer-facing Copilot skills as a plugin.

What

Adds a Copilot skills plugin at plugins/dotnet-maui/ containing 46 skills and a builder agent for .NET MAUI app developers. This is separate from the existing contributor-facing skills in .github/skills/.

The plugin can be installed via:

/plugin marketplace add dotnet/maui
/plugin install dotnet-maui@dotnet-maui

Why

The repo already has 13 skills + 4 agents for contributors (PR review, issue triage, test writing). But there's nothing for the framework's customers — the developers building apps with .NET MAUI. Shipping skills from this repo means they co-evolve with the framework and are maintained by the team that knows the APIs best.

What's included

46 Skills across 10 categories

Category Count Examples
Scaffolding 2 scaffold-page, scaffold-content-view
Architecture 7 setup-mvvm, dependency-injection, shell-navigation, custom-handlers
Guardrails 2 coding-guardrails (NEVER rules), current-apis (API currency)
UI & Controls 7 collectionview, animations, gestures, theming, safe-area
Platform APIs 9 geolocation, secure-storage, media-picker, notifications, maps
Data & Networking 3 rest-api, sqlite-database, authentication
Web & Hybrid 3 hybridwebview, deep-linking, aspire
Quality 6 accessibility, performance, unit-testing, localization
Native Bindings 2 android-slim-bindings, ios-slim-bindings
Migration 3 xamarin-forms, xamarin-android, xamarin-ios
Tooling 2 workload-discovery, release-notes

Builder Agent

A maui-app-builder agent that orchestrates skills for complex requests like "build me a todo app with navigation, data persistence, and theming."

Sources & Attribution

This plugin consolidates and builds on existing community work (all MIT licensed):

Open Questions

  1. Should this live in dotnet/maui or a separate repo? Currently proposed as in-repo so skills co-evolve with the framework.
  2. Naming: Should adopted skills keep the maui- prefix or use a different convention?
  3. Maintenance: How do we keep skills current as APIs change? Should CI validate skill content?
  4. Scope: Are there categories that should be added or removed?
  5. Guardrails: The maui-coding-guardrails skill embeds "NEVER" rules (no ListView, no renderers, etc.) — is this the right set?

cc @davidortinau @Redth

…agent)

This is an exploratory RFC — not a final proposal. The idea is to ship a
Copilot skills plugin directly from this repo so .NET MAUI app developers
can install curated, framework-team-maintained skills for building apps.

The plugin lives at plugins/dotnet-maui/ and includes:
- 37 skills adopted from davidortinau/maui-skills (MIT)
- 4 skills adopted from Redth/maui-skillz (MIT)
- 3 original skills (scaffold-page, scaffold-content-view, setup-mvvm)
- 1 always-on guardrail skill (maui-coding-guardrails) based on
  github/awesome-copilot dotnet-maui.agent.md
- 1 always-on API currency guardrail (maui-current-apis)
- 1 builder agent (maui-app-builder) that orchestrates skills for
  complex multi-step requests
- Plugin manifests for both GitHub Copilot and Claude Code
- Updated copilot-instructions.md distinguishing contributor vs customer skills

Skill categories: scaffolding, MVVM, Shell navigation, dependency injection,
platform APIs (geolocation, camera, storage, notifications, maps, etc.),
data/networking (REST, SQLite, auth), native bindings (iOS/Android NLI),
Blazor Hybrid, theming, accessibility, performance, localization,
hot reload diagnostics, workload discovery, and Xamarin migration.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions
Copy link
Contributor

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.sh | bash -s -- 34429

Or

  • Run remotely in PowerShell:
iex "& { $(irm https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.ps1) } 34429"

jfversluis added a commit to jfversluis/skills that referenced this pull request Mar 16, 2026
Add two always-on guardrail skills for .NET MAUI development:

- maui-coding-guardrails: Prevents use of obsolete controls (ListView,
  TableView, Frame), deprecated patterns (renderers, BackgroundColor),
  and common architectural mistakes (ScrollView inside StackLayout,
  mixing Shell with NavigationPage). Includes control reference tables,
  compiled bindings guidance, and handler customization patterns.

- maui-current-apis: Prevents use of deprecated APIs across .NET MAUI
  versions. Includes a reasoning framework for detecting project TFM
  and library versions, comprehensive deprecated API tables for .NET
  MAUI 10, and guidance for MauiReactor and Blazor Hybrid scenarios.

Both skills include eval scenarios for validation.

Sourced from dotnet/maui#34429 (RFC by jfversluis), which consolidates
work from davidortinau/maui-skills and github/awesome-copilot.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant