dotnet / dotnet/docs-maui

[maui-labs docs] Update plugin installation instructions for DevFlow skills split (maui-labs PR #375)

Open Beginner friendly
#3,499 0 comments 0 reactions 0 assignees View on GitHub
:watch: Not Triaged
Dominant language
No language data
Stars
282
Forks
265
Avg merge
2d 2h
Merged PRs (30d)
19

Description

## Source PR

**PR**: https://github.com/dotnet/maui-labs/pull/375
**Title**: Split MAUI skills into app and tooling plugins
**Author**: jfversluis
**Merged**: 2026-09-02

---

## Summary of Changes

PR #375 reorganizes the maui-labs agent skills marketplace by splitting the single `dotnet-maui` plugin into two distinct plugins:

| Plugin | Purpose | Install command |
|--------|---------|-----------------|
| `dotnet-maui` | App-development skills (architecture, UI, accessibility, testing, Blazor Hybrid, etc.) | `/plugin install dotnet-maui@dotnet-maui-labs` |
| `dotnet-maui-tooling` | Specialist tooling skills — DevFlow automation, slim bindings, workload diagnostics | `/plugin install dotnet-maui-tooling@dotnet-maui-labs` |

**Key change for users**: The DevFlow runtime skills that ship with the `maui` CLI (`maui-devflow-onboard`, `maui-devflow-debug`, `maui-devflow-session-review`) have moved from `plugins/dotnet-maui/skills/` to `plugins/dotnet-maui-tooling/skills/`. Users who previously installed only `dotnet-maui` to get DevFlow capabilities now need to install `dotnet-maui-tooling` instead.

Additional skills moved to `dotnet-maui-tooling`:
- `devflow-connect` — diagnose agent connectivity issues
- `devflow-automation` — automate inspection/debug workflows
- `android-slim-bindings`, `ios-slim-bindings` — Native Library Interop
- `dotnet-workload-info` — workload/version discovery
- `maui-ai-debugging` — legacy DevFlow compatibility

---

## Documentation Pages Affected

If any of the following exist in `dotnet/docs-maui`, they need updating:

- `docs/developer-tools/devflow/` — DevFlow setup and onboarding pages that mention plugin installation
- `docs/developer-tools/cli/` — `maui devflow init` documentation that references plugin names
- `docs/developer-tools/index.md` — landing page listing available tools and plugins

---

## Suggested Changes

### 1. DevFlow setup / onboarding page (likely `docs/developer-tools/devflow/get-started.md` or similar)

**Before** (old plugin name):
```bash
# Add the maui-labs marketplace
/plugin marketplace add dotnet/maui-labs

# Install DevFlow skills
/plugin install dotnet-maui@dotnet-maui-labs
```

**After** (correct plugin name for DevFlow skills):
```bash
# Add the maui-labs marketplace
/plugin marketplace add dotnet/maui-labs

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

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

### 2. Any table listing available skills/plugins

The old single-row table should become two rows:

| Plugin | Description | Install |
|--------|-------------|---------|
| `dotnet-maui` | Skills for building .NET MAUI apps: architecture, UI, accessibility, testing, performance, platform integration, migration, and app features. | `/plugin install dotnet-maui@dotnet-maui-labs` |
| `dotnet-maui-tooling` | Specialist skills for DevFlow automation, platform bindings, workload discovery, and diagnostics. | `/plugin install dotnet-maui-tooling@dotnet-maui-labs` |

### 3. `maui devflow init` CLI documentation

If docs describe what `maui devflow init` installs, note that it now installs skills from `dotnet-maui-tooling` (not `dotnet-maui`). From the maui-labs README:

> 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.

---

## Notes for Docs Author

- If no existing docs reference the plugin install commands or skill names, this issue can be closed without changes.
- The skills themselves (`maui-devflow-onboard`, etc.) have not changed in content — only their plugin location changed.
- Reference for the updated plugin structure: [`plugins/README.md`](https://github.com/dotnet/maui-labs/blob/main/plugins/README.md)

> Generated by [PR Documentation Check](https://github.com/dotnet/maui-labs/actions/runs/33618017341) for issue #375 · [◷](https://github.com/search?q=repo%3Adotnet%2Fdocs-maui+is%3Aissue+%22gh-aw-workflow-call-id%3A+dotnet%2Fmaui-labs%2Fpr-docs-check%22&type=issues)

Contributor guide

Open the contributing guide

Research direction

Search docs/developer-tools/devflow/, docs/developer-tools/cli/, and docs/developer-tools/index.md for dotnet-maui, dotnet-maui-tooling, and DevFlow skill names. Compare references with maui-labs plugins/README.md and update installation commands, plugin tables, and maui devflow init details where needed. Done means the documentation reflects the split; close the issue without changes if no references exist.

Written by the indexing model from the issue text.

Assessment

Tech stack
cli
Domain
cli, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.