Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
b5d83f8
Add winui-uwp-migration skill
niels9001 May 19, 2026
fd3588b
feat(winui-uwp-migration): iterative skill improvements
Jun 17, 2026
65ae39e
docs(winui-uwp-migration): clarify behavior fidelity rules
Jun 18, 2026
020b570
fix: prevent bootstrap from overwriting WinUI 3 scaffold manifest wit…
Jun 23, 2026
3b26552
perf(skill): add efficiency rules to SKILL.md Step 1
Jun 24, 2026
0138794
fix(skill): add dialProtocol extension + CS0111 duplicate method guid…
Jun 24, 2026
b37cc52
feat: add todoIndex to bootstrap-meta.json, VirtualizingStackPanel gu…
Jun 25, 2026
e564dc0
fix(winui-uwp-migration): prevent blank-screen failures via shell-wir…
Jul 2, 2026
96ddf7e
fix(bootstrap): Navigate injection now works when MainPage.xaml is in…
Jul 7, 2026
1a9ee18
fix(bootstrap): auto-merge SharedContent (Styles.xaml + MainPage) int…
Jul 7, 2026
8506d80
Optimize migration skill: per-file build cadence + validator loop cap
Jul 13, 2026
4538995
Detect nested duplicate project (stray AppX source copy) in validator
Jul 13, 2026
55000c7
Decouple SEQUENTIAL edit-pacing from build cadence (P2 token trim)
Jul 14, 2026
e4bb453
chore: remove stray seq.py rebase helper (not part of skill)
qiutongMS Jul 17, 2026
07bf53e
Merge branch 'staging' into user/qiutongshen/winuiUwpMigrationSkill-b…
nmetulev Jul 21, 2026
54c3581
Hotfix: sync Claude/Codex adapter manifest versions (0.6.1)
niels9001 Sep 9, 2026
f94bab1
Merge pull request #179 from microsoft/hotfix/sync-adapter-versions
niels9001 Sep 9, 2026
ad5cc24
Merge branch 'staging' into user/qiutongshen/winuiUwpMigrationSkill-b…
niels9001 Sep 20, 2026
79d6a30
Merge remote-tracking branch 'upstream/main' into user/qiutongshen/wi…
niels9001 Sep 20, 2026
f2b8518
Fix UWP migration plugin integration
niels9001 Sep 20, 2026
e62cb1a
Harden UWP migration workflow
niels9001 Sep 20, 2026
94f79dc
Fix validator manifest namespace handling
niels9001 Sep 20, 2026
196d076
Isolate PowerShell regression processes
niels9001 Sep 20, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/skills/pr-review/dimensions/docs-and-manifests.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ When code or skills change, these need to keep up:
### New / renamed / removed skill

- **New skill added under `plugins/winui/agent-plugin/skills/<new>/`** without a
matching row in `README.md`'s "eight skills" table → **high**.
matching row in `README.md`'s "nine skills" table → **high**.
- **Skill renamed.** Both orchestrator agent files reference skills by name
(e.g. "Load the `winui-dev-workflow` skill"). Renames must update every
mention in both agent files and in any sibling skill that links to it.
Expand Down
22 changes: 22 additions & 0 deletions .github/workflows/pr-validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,28 @@ permissions:
contents: read

jobs:
uwp-migration-regressions:
name: UWP migration PowerShell regressions
runs-on: windows-latest
steps:
- name: Checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1

- name: Run migration script regressions
shell: pwsh
run: |
$tests = @(
'plugins/winui/agent-plugin/skills/winui-uwp-migration/scripts/tests/Initialize-UwpMigration.Bootstrap.Tests.ps1',
'plugins/winui/agent-plugin/skills/winui-uwp-migration/scripts/tests/Validate-UwpMigration.Tests.ps1',
'plugins/winui/agent-plugin/skills/winui-uwp-migration/scripts/tests/Get-WinUIDefaultStyle.Tests.ps1'
)
foreach ($test in $tests) {
& pwsh -NoProfile -File $test
if ($LASTEXITCODE -ne 0) {
throw "$test failed with exit code $LASTEXITCODE"
}
}

build-tools:
name: Build C# tools
runs-on: ubuntu-latest
Expand Down
17 changes: 17 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,23 @@ The `version-bump` and `changelog-entry` CI jobs enforce this.

### Added

- New `winui-uwp-migration` skill: tool-driven UWP → WinUI 3 / Windows App
SDK migration. Ships:
- `Initialize-UwpMigration.ps1` bootstrap — copies UWP source, applies
namespace rewrites, classifies each file for coherent batch or
dependency-ordered migration, and injects inline `TODO[migrate-NNN]`
markers anchored to a pattern.
- `Validate-UwpMigration.ps1` validator — residue grep, mapping
integrity, build healthcheck, and a 10s runtime smoke launch that
catches startup races (E_POINTER, init-order bugs).
- `Get-MigrationPattern.ps1` — fetches a single section of the patterns
reference by anchor to keep agent context small.
- `MIGRATION-PATTERNS.md` — per-anchor patterns for threading,
windowing, csproj, storage, navigation, capture, and unsupported APIs.
- `SKILL.md` guidance on removing migration TODOs, documenting adaptations
with `MIGRATION-PATTERNS.md#<anchor>`, and scoped defensive UI fallbacks
for known device-unavailable and permission failures.

### Changed

### Fixed
Expand Down
9 changes: 5 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ git clone https://github.com/microsoft/win-dev-skills
openclaw plugins install ./win-dev-skills/plugins/winui
```

Verify the eight skills loaded with `openclaw skills list` (each shows `✓ ready`).
Verify the nine skills loaded with `openclaw skills list` (each shows `✓ ready`).

> **Note:** OpenClaw maps skills, not agents, so the `winui-dev` orchestrator agent isn't exposed there. The skills still work - ask the agent for a WinUI task and it loads the relevant skill on demand.
</details>
Expand Down Expand Up @@ -176,9 +176,9 @@ scripts/ Helper scripts (see scripts/build-tools.ps1)

### The agent: `winui-dev`

A focused agent for WinUI 3 / Windows App SDK / XAML / C# work. Use it for new apps, adding features, converting from WPF/Electron/web, or fixing bugs. It pulls in the skills below as needed.
A focused agent for WinUI 3 / Windows App SDK / XAML / C# work. Use it for new apps, adding features, porting from UWP/WPF/Electron/web, or fixing bugs. It pulls in the skills below as needed.

### The eight skills
### The nine skills

Each skill is a focused, self-contained playbook. The agent loads `winui-design` and `winui-dev-workflow` by default — those cover most "build me a WinUI 3 app" requests end-to-end. You opt into the others when you want them, including `winui-setup` for one-time machine prep.

Expand All @@ -189,6 +189,7 @@ Each skill is a focused, self-contained playbook. The agent loads `winui-design`
| **`winui-code-review`** | Code-quality review before committing — MVVM compliance, `x:Bind` correctness, accessibility, theming, security, performance. Catches what the compiler and UI tests won't. |
| **`winui-ui-testing`** | Automated UI testing — generates a batch test script, runs all tests in one pass, reads results. Covers element assertions, interactions, value checks (TextBox, ComboBox, ToggleSwitch), file pickers, flyouts, dialogs, persistence, accessibility audits. |
| **`winui-packaging`** | MSIX packaging, code signing, and distribution — release builds, certificate generation (`winapp cert generate`), trust, signing (`winapp sign`), self-contained deployment, GitHub Actions CI/CD, and Microsoft Store submission. |
| **`winui-uwp-migration`** | UWP → WinUI 3 migration — bootstraps the target project, classifies files for batch or sequential migration, maps unsupported APIs to grounded patterns, and validates residue, build health, and startup behavior. |
| **`winui-wpf-migration`** | WPF → WinUI 3 migration — namespace replacement, control mapping (`DataGrid` → `ListView`, `WrapPanel` → `ItemsRepeater`, `TabControl` → `TabView`), `Dispatcher` → `DispatcherQueue`, `System.Drawing` → `BitmapImage`, MVVM conversion to CommunityToolkit.Mvvm, `DynamicResource` → `ThemeResource`. |
| **`winui-session-report`** | Diagnostic report on the current or a recent Copilot session. Runs only after an explicit request for session feedback, agent debugging, or a review of what happened during a build session. |
| **`winui-setup`** | Install and verify machine prerequisites — .NET SDK 8.0.100+, WinApp CLI 0.6+, and Developer Mode. Templates are managed on demand by `winapp new`. Idempotent and **explicit confirmation required**. |
Expand Down Expand Up @@ -260,7 +261,7 @@ The plugin follows the vendor-neutral [Agent Plugins 1.0 specification](https://

Agent Plugins 1.0 standardizes [skills and MCP server packaging](https://github.com/agentplugins/agent-plugins-spec/blob/main/spec/1.0.0.md#7-component-types), but it does not standardize custom agents. The `winui-dev` agent therefore lives under GitHub Copilot's [`com.github.copilot/` extension namespace](https://github.blog/changelog/2026-08-12-agent-plugins-1-0-in-vs-code-copilot-cli-and-the-copilot-app/) and is mirrored in the outer compatibility package's `agents/` directory for Claude Code. CI requires both copies to remain content-identical.

The separate package roots are intentional. The Agent Plugins specification requires [client-specific files to use reverse-domain top-level namespaces](https://github.com/agentplugins/agent-plugins-spec/blob/main/spec/1.0.0.md#8-client-extensions), while Claude Code and OpenAI Codex still require `.claude-plugin/plugin.json` and `.codex-plugin/plugin.json` at the root of the package they install, and OpenClaw requires its own root manifest and JavaScript entry point. GitHub Copilot and other conforming clients therefore install `plugins/winui/agent-plugin`; the Claude, Codex, and OpenClaw integrations install the containing `plugins/winui` compatibility package and reference the canonical `agent-plugin/skills/` directory. This follows the specification's [additive migration guidance](https://github.com/agentplugins/agent-plugins-example/blob/main/skills/migrate-agent-plugin/references/migration-guide.md#6-preserve-platform-behavior) without duplicating the eight skills or their binary payloads.
The separate package roots are intentional. The Agent Plugins specification requires [client-specific files to use reverse-domain top-level namespaces](https://github.com/agentplugins/agent-plugins-spec/blob/main/spec/1.0.0.md#8-client-extensions), while Claude Code and OpenAI Codex still require `.claude-plugin/plugin.json` and `.codex-plugin/plugin.json` at the root of the package they install, and OpenClaw requires its own root manifest and JavaScript entry point. GitHub Copilot and other conforming clients therefore install `plugins/winui/agent-plugin`; the Claude, Codex, and OpenClaw integrations install the containing `plugins/winui` compatibility package and reference the canonical `agent-plugin/skills/` directory. This follows the specification's [additive migration guidance](https://github.com/agentplugins/agent-plugins-example/blob/main/skills/migrate-agent-plugin/references/migration-guide.md#6-preserve-platform-behavior) without duplicating the nine skills or their binary payloads.

Marketplace artwork is available as [`assets/logo.svg`](plugins/winui/agent-plugin/assets/logo.svg) and [`assets/logo-512.png`](plugins/winui/agent-plugin/assets/logo-512.png). Codex references these files from its client-specific manifest; other marketplace publishing flows can upload them directly. They are intentionally not declared in the portable manifest because `logo` is not part of the [Agent Plugins 1.0 manifest schema](https://agent-plugins.org/schemas/1.0.0/plugin.schema.json).

Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
---
name: winui-dev
description: "Builds WinUI 3 desktop applications using Windows App SDK, XAML, and C#. Use for creating new apps, adding features, converting from WPF/Electron/web, fixing bugs, or any WinUI 3 / WinAppSDK / XAML task."
description: "Builds WinUI 3 desktop applications using Windows App SDK, XAML, and C#. Use for creating new apps, adding features, porting from UWP/WPF/Electron/web, fixing bugs, or any WinUI 3 / WinAppSDK / XAML task."
user-invocable: true
---

## You Are The WinUI Developer — Do The Work Yourself

You are `winui-dev` — don't call `task` with `agent_type: "winui:winui-dev"` (self-hop). `task` is fine for scoped helpers (`explore` for parallel codebase mapping, `general-purpose` for rubber-duck critique), not for the build itself.

For C# UWP → WinUI 3 / Windows App SDK migrations, invoke the `winui-uwp-migration` skill immediately.

## Process

You build WinUI 3 desktop apps following this process: understand requirements → design and plan UI → scaffold if needed → write code → build & run. The user might ask you to use other steps defined by skills such as `winui-ui-testing` for UI validation or `winui-code-review` for quality checks if desired only.
Expand Down
Loading
Loading