[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M699KGQJ4QXZBMBZKVTE2T78":3,"skill-same:01M699KGQJ4QXZBMBZKVTE2T78":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":51,"ownerDescription":52,"updatedAt":53,"install":54,"resources":67},"01M699KGQJ4QXZBMBZKVTE2T78","winapp-troubleshoot",null,"Diagnose Windows app packaging, signing, install, identity, and SDK errors: untrusted or mismatched certificates, Add-AppxPackage and 0x80073CFx install failures, no package identity, C++\u002FWinRT headers not generated. Use when an MSIX won't install or build, or an error code appears.","microsoft\u002FwinappCli","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M699J7Q2FM9V32CFV0Q8VPF9",1381,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinapp\u002Fskills\u002Fwinapp-troubleshoot\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"troubleshoot","winapp troubleshoot","when","install","headers","build","certificates","signing","code","use","package","generated","errors","packaging","diagnose","c++","app","error","mismatched","sdk","windows","2026-11-10 10:12:30",false,"---\nname: winapp-troubleshoot\ndescription: \"Diagnose Windows app packaging, signing, install, identity, and SDK errors: untrusted or mismatched certificates, Add-AppxPackage and 0x80073CFx install failures, no package identity, C++\u002FWinRT headers not generated. Use when an MSIX won't install or build, or an error code appears.\"\n---\n\n**If you can't run `winapp` yourself** (no shell, or the command is denied), give the user the exact `winapp` command(s) for their project instead of only describing the steps.\n\n## When to use\n\nUse this skill when:\n- **Diagnosing errors** from winapp CLI commands\n- **Choosing the right command** for a task\n- **Understanding prerequisites** — what each command needs and what it produces\n\n## Common errors & solutions\n\nFor slow WinUI layout or scrolling, use the `winapp-performance` skill.\nETW performance capture is separate from debugger output and crash analysis.\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| \"winapp.yaml not found\" | Running `restore` or `update` without config | Run `winapp init` first, or `cd` to the directory containing `winapp.yaml` |\n| \"Package.appxmanifest not found\" | Running `package`, `create-debug-identity`, or `cert generate --manifest` | Run `winapp init` or `winapp manifest generate` first, or pass `--manifest \u003Cpath>` |\n| \"Publisher mismatch\" | Certificate publisher ≠ manifest publisher | Regenerate cert: `winapp cert generate --manifest`, or edit `Package.appxmanifest` `Identity.Publisher` to match |\n| \"Access denied\" \u002F \"elevation required\" | `cert install` without admin | Run terminal as Administrator for `winapp cert install` |\n| \"Package installation failed\" | Cert not trusted, or stale package registration | For a certificate error, `winapp cert install .\u002Fdevcert.pfx` (admin). For registration conflicts, see the rows below rather than deleting packages by name |\n| \"Certificate not trusted\" | Dev cert not installed on machine | `winapp cert install .\u002Fdevcert.pfx` (admin) |\n| \"Build tools not found\" | First run, tools not yet downloaded | Run `winapp update` to download tools; ensure internet access |\n| \"Failed to add package identity\" | Stale debug identity or untrusted cert | Run `winapp unregister` with your app's input (or `--manifest` for `create-debug-identity`); install a certificate only if the error asks for it |\n| \"Certificate file already exists\" | `devcert.pfx` already present | Use `winapp cert generate --if-exists overwrite` or `--if-exists skip` |\n| \"Manifest already exists\" | `Package.appxmanifest` already present | Use `winapp manifest generate --if-exists overwrite` or edit manifest directly |\n| `run` \u002F `create-debug-identity` registration error `0x800704EC` | Developer Mode is disabled | Enable it in **Settings → Privacy & security → For developers**, or `Set-ItemProperty -Path 'HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\AppModelUnlock' -Name AllowDevelopmentWithoutDevLicense -Value 1`, then retry |\n| Two worktrees of the same app keep replacing each other's registration | Both copies share one package identity | Run each with `winapp run . --unique-identity` (supported packaged apps) so each gets its own identity and app data |\n| `run` \u002F `create-debug-identity` registration error `0x80073CFB` | Package already registered with a conflicting identity | Run `winapp unregister` with your app's input, then retry. Use `--force` only if you are sure the same-named package registered elsewhere is yours |\n| App's Start menu entry launches nothing, silently | Package still registered after its files were deleted | Run `winapp unregister --prune` to remove every dev registration whose files are gone |\n| `run` reports access denied or a file in use during a rebuild | Permissions or a file held open; access denied alone does not identify a lock owner | Check the reported paths and permissions. `winapp run` closes a copy of the app running from the same layout before replacing its files; close any other process holding the file and retry. |\n| \"winapp can't write the API index\" \u002F \"can't install the Microsoft Store Developer CLI\" | `%USERPROFILE%\\.winapp` isn't writable (for example, an agent sandbox) | Set `WINAPP_CLI_CACHE_DIRECTORY` to a writable folder, such as one inside the project, and retry. Other commands keep working without it |\n\nFor `--unique-identity` errors about unsupported extensions or resources, see\n[unique identity for parallel checkouts](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fusage.md#unique-identity-for-parallel-checkouts).\nRun without the flag instead of working around the check.\n\n## Command selection guide\n\n```\nIs the app a single .cs file (.NET file-based app)?\n├─ Yes → winapp run \u003Cfile>.cs  (builds it and generates the manifest for you)\n└─ No → Does the project have a Package.appxmanifest?\n   ├─ No → Do you want full setup (manifest + config + optional SDKs)?\n   │       ├─ Yes → winapp init (adds Windows platform files to existing project)\n   │       └─ No, just a manifest → winapp manifest generate\n   └─ Yes\n      ├─ Has winapp.yaml, cloned\u002Fpulled but .winapp\u002F folder missing?\n      │  └─ winapp restore\n      ├─ Want newer SDK versions?\n      │  └─ winapp update\n      ├─ Need a dev certificate?\n      │  └─ winapp cert generate (then winapp cert install for trust)\n      ├─ Need package identity for debugging? (see [Debugging Guide](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fdebugging.md))\n      │  ├─ Exe is in your build output folder? (most frameworks)\n      │  │  └─ winapp run \u003Cbuild-output-dir>\n      │  └─ Exe is separate from app code? (Electron, sparse testing)\n      │     └─ winapp create-debug-identity \u003Cexe>\n      ├─ Ready to create MSIX installer?\n      │  └─ winapp package \u003Cbuild-output> --cert .\u002Fdevcert.pfx\n      ├─ Need to sign an existing file?\n      │  └─ winapp sign \u003Cfile> \u003Ccert>\n      ├─ Need to update app icons?\n      │  └─ winapp manifest update-assets .\u002Flogo.png\n      ├─ Need to run SDK tools directly?\n      │  └─ winapp tool \u003Ctoolname> \u003Cargs>\n      ├─ Need to publish to Microsoft Store?\n      │  └─ winapp store \u003Cargs> (passthrough to Store Developer CLI)\n      └─ Need the .winapp directory path for build scripts?\n         └─ winapp get-winapp-path (or --global for shared cache)\n```\n\n**Important notes:**\n- `winapp init` adds files to an **existing** project — it does not create a new project\n- The key prerequisite for most commands is `Package.appxmanifest`, not `winapp.yaml`\n- `winapp.yaml` is only needed for SDK version management (`restore`\u002F`update`)\n- Projects with NuGet package references (e.g., `.csproj` referencing `Microsoft.Windows.SDK.BuildTools`) can use winapp commands without `winapp.yaml`\n- For Electron projects, use the npm package (`npm install --save-dev @microsoft\u002Fwinappcli`) which includes Node.js-specific commands under `npx winapp node`\n\n## Debugging approach quick reference\n\n| Goal | Command | Key detail |\n|------|---------|------------|\n| Run with identity (most common) | `winapp run .\\build\\Debug` | Registers loose layout + launches; a console app gets an execution alias automatically |\n| Attach debugger to running app | `winapp run .\\build\\Debug` → attach to PID | Misses startup code |\n| Register identity, launch manually | `winapp run .\\build\\Debug --no-launch` | Launch via `start shell:AppsFolder\\\u003CAUMID>` or execution alias — **not** the exe directly |\n| F5 startup debugging (IDE launches exe) | `winapp create-debug-identity .\\bin\\myapp.exe` | Exe has identity regardless of how it's launched; best for debugging activation\u002Fstartup code |\n| Capture OutputDebugString + crash dump | `winapp run .\\build\\Debug --debug-output` | On crash, writes minidump and shows exception type, message, and faulting methods. **Blocks other debuggers** — use `--no-launch` if you need VS Code\u002FWinDbg |\n| Run and auto-clean | `winapp run .\\build\\Debug --unregister-on-exit` | Unregisters the dev package after the app exits |\n| Launch and detach (CI) | `winapp run .\\build\\Debug --detach` | Returns immediately after launch; use `--json` to get PID for scripting |\n| Clean up this app's registration | `winapp unregister .` | Pass the same input as `run`; works with or without `--unique-identity` |\n| Start menu entry does nothing when clicked | `winapp unregister --prune` | The package is registered but its files were deleted, so activation silently fails. Prune removes every dev registration whose files are gone |\n\n> **Visual Studio users:** If you have a packaging project, VS already handles identity and debugging from F5 — you likely don't need winapp for debugging. These workflows are for VS Code, terminal, and frameworks VS doesn't natively package.\n\nFor full details, see the [Debugging Guide](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fdebugging.md).\n\n## Prerequisites & state matrix\n\n| Command | Requires | Creates\u002FModifies |\n|---------|----------|------------------|\n| `init` | Existing project (any framework) | `winapp.yaml`, `.winapp\u002F`, `Package.appxmanifest`, `Assets\u002F`, `.gitignore` update |\n| `restore` | `winapp.yaml` | `.winapp\u002Fpackages\u002F`, generated projections |\n| `update` | `winapp.yaml` | Updates versions in `winapp.yaml`, reinstalls packages |\n| `manifest generate` | Nothing | `Package.appxmanifest`, `Assets\u002F` |\n| `manifest update-assets` | `Package.appxmanifest` + source image | Regenerates `Assets\u002F` icons |\n| `cert generate` | Nothing (or `Package.appxmanifest` for publisher) | `devcert.pfx` |\n| `cert install` | Certificate file + admin | Machine certificate store |\n| `create-debug-identity` | `Package.appxmanifest` + exe + trusted cert | Registers sparse package with Windows |\n| `run` | Build output folder + `Package.appxmanifest`; **or** a `.csproj`\u002F`.vcxproj`\u002F`.sln` (C++ needs Visual Studio or Build Tools with the C++ workload); **or** a `.cs` file-based app (no manifest needed — one is generated) | Registers loose layout package, launches app |\n| `unregister` | The same input passed to `run` (`.cs`, `.csproj`\u002F`.vcxproj`, or folder), or `--manifest` | Removes the development registration that `run` or `create-debug-identity` created |\n| `package` | Build output + `Package.appxmanifest` | `.msix` file |\n| `sign` | File + certificate | Signed file (in-place) |\n| `create-external-catalog` | Directory with executables | `CodeIntegrityExternal.cat` |\n| `tool \u003Cname>` | Nothing (auto-downloads tools) | Runs SDK tool directly |\n| `store` | Nothing (auto-downloads Store CLI) | Passthrough to Microsoft Store Developer CLI |\n| `get-winapp-path` | Nothing | Prints `.winapp` directory path |\n\n## Debugging tips\n\n- Add `--verbose` (or `-v`) to any command for detailed output\n- Add `--quiet` (or `-q`) to suppress progress messages (useful in CI\u002FCD)\n- Run `winapp --cli-schema` to get the full JSON schema of all commands and options\n- Run any command with `--help` for its specific usage information\n- Use `winapp get-winapp-path` to find where packages are stored locally\n- Use `winapp get-winapp-path --global` to find the shared cache location\n\n## Getting more help\n\n- Full CLI documentation: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fusage.md\n- Framework-specific guides: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Ftree\u002Fmain\u002Fdocs\u002Fguides\n- File an issue: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fissues\n\n## Related skills\n- **Setup & init**: `winapp-setup` — adding Windows support to a project\n- **Manifest**: `winapp-manifest` — creating and editing `Package.appxmanifest`\n- **Signing**: `winapp-signing` — certificate generation and management\n- **Packaging**: `winapp-package` — creating MSIX installers\n- **Identity**: `winapp-identity` — enabling package identity for Windows APIs\n- **Frameworks**: `winapp-frameworks` — framework-specific guidance (Electron, .NET, C++, Rust, Flutter, Tauri)\n- **MAUI**: `winapp-maui` — packaging\u002Fsigning .NET MAUI Windows apps and resolving the resizetizer manifest\n\n## CLI reference\n\nRun `winapp \u003Ccommand> --help` for current command options, or `winapp --cli-schema` for the complete machine-readable command schema.\n","**If you can't run `winapp` yourself** (no shell, or the command is denied), give the user the exact `winapp` command(s) for their project instead of only describing the steps.\n\n## When to use\n\nUse this skill when:\n- **Diagnosing errors** from winapp CLI commands\n- **Choosing the right command** for a task\n- **Understanding prerequisites** — what each command needs and what it produces\n\n## Common errors & solutions\n\nFor slow WinUI layout or scrolling, use the `winapp-performance` skill.\nETW performance capture is separate from debugger output and crash analysis.\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| \"winapp.yaml not found\" | Running `restore` or `update` without config | Run `winapp init` first, or `cd` to the directory containing `winapp.yaml` |\n| \"Package.appxmanifest not found\" | Running `package`, `create-debug-identity`, or `cert generate --manifest` | Run `winapp init` or `winapp manifest generate` first, or pass `--manifest \u003Cpath>` |\n| \"Publisher mismatch\" | Certificate publisher ≠ manifest publisher | Regenerate cert: `winapp cert generate --manifest`, or edit `Package.appxmanifest` `Identity.Publisher` to match |\n| \"Access denied\" \u002F \"elevation required\" | `cert install` without admin | Run terminal as Administrator for `winapp cert install` |\n| \"Package installation failed\" | Cert not trusted, or stale package registration | For a certificate error, `winapp cert install .\u002Fdevcert.pfx` (admin). For registration conflicts, see the rows below rather than deleting packages by name |\n| \"Certificate not trusted\" | Dev cert not installed on machine | `winapp cert install .\u002Fdevcert.pfx` (admin) |\n| \"Build tools not found\" | First run, tools not yet downloaded | Run `winapp update` to download tools; ensure internet access |\n| \"Failed to add package identity\" | Stale debug identity or untrusted cert | Run `winapp unregister` with your app's input (or `--manifest` for `create-debug-identity`); install a certificate only if the error asks for it |\n| \"Certificate file already exists\" | `devcert.pfx` already present | Use `winapp cert generate --if-exists overwrite` or `--if-exists skip` |\n| \"Manifest already exists\" | `Package.appxmanifest` already present | Use `winapp manifest generate --if-exists overwrite` or edit manifest directly |\n| `run` \u002F `create-debug-identity` registration error `0x800704EC` | Developer Mode is disabled | Enable it in **Settings → Privacy & security → For developers**, or `Set-ItemProperty -Path 'HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\AppModelUnlock' -Name AllowDevelopmentWithoutDevLicense -Value 1`, then retry |\n| Two worktrees of the same app keep replacing each other's registration | Both copies share one package identity | Run each with `winapp run . --unique-identity` (supported packaged apps) so each gets its own identity and app data |\n| `run` \u002F `create-debug-identity` registration error `0x80073CFB` | Package already registered with a conflicting identity | Run `winapp unregister` with your app's input, then retry. Use `--force` only if you are sure the same-named package registered elsewhere is yours |\n| App's Start menu entry launches nothing, silently | Package still registered after its files were deleted | Run `winapp unregister --prune` to remove every dev registration whose files are gone |\n| `run` reports access denied or a file in use during a rebuild | Permissions or a file held open; access denied alone does not identify a lock owner | Check the reported paths and permissions. `winapp run` closes a copy of the app running from the same layout before replacing its files; close any other process holding the file and retry. |\n| \"winapp can't write the API index\" \u002F \"can't install the Microsoft Store Developer CLI\" | `%USERPROFILE%\\.winapp` isn't writable (for example, an agent sandbox) | Set `WINAPP_CLI_CACHE_DIRECTORY` to a writable folder, such as one inside the project, and retry. Other commands keep working without it |\n\nFor `--unique-identity` errors about unsupported extensions or resources, see\n[unique identity for parallel checkouts](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fusage.md#unique-identity-for-parallel-checkouts).\nRun without the flag instead of working around the check.\n\n## Command selection guide\n\n```\nIs the app a single .cs file (.NET file-based app)?\n├─ Yes → winapp run \u003Cfile>.cs  (builds it and generates the manifest for you)\n└─ No → Does the project have a Package.appxmanifest?\n   ├─ No → Do you want full setup (manifest + config + optional SDKs)?\n   │       ├─ Yes → winapp init (adds Windows platform files to existing project)\n   │       └─ No, just a manifest → winapp manifest generate\n   └─ Yes\n      ├─ Has winapp.yaml, cloned\u002Fpulled but .winapp\u002F folder missing?\n      │  └─ winapp restore\n      ├─ Want newer SDK versions?\n      │  └─ winapp update\n      ├─ Need a dev certificate?\n      │  └─ winapp cert generate (then winapp cert install for trust)\n      ├─ Need package identity for debugging? (see [Debugging Guide](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fdebugging.md))\n      │  ├─ Exe is in your build output folder? (most frameworks)\n      │  │  └─ winapp run \u003Cbuild-output-dir>\n      │  └─ Exe is separate from app code? (Electron, sparse testing)\n      │     └─ winapp create-debug-identity \u003Cexe>\n      ├─ Ready to create MSIX installer?\n      │  └─ winapp package \u003Cbuild-output> --cert .\u002Fdevcert.pfx\n      ├─ Need to sign an existing file?\n      │  └─ winapp sign \u003Cfile> \u003Ccert>\n      ├─ Need to update app icons?\n      │  └─ winapp manifest update-assets .\u002Flogo.png\n      ├─ Need to run SDK tools directly?\n      │  └─ winapp tool \u003Ctoolname> \u003Cargs>\n      ├─ Need to publish to Microsoft Store?\n      │  └─ winapp store \u003Cargs> (passthrough to Store Developer CLI)\n      └─ Need the .winapp directory path for build scripts?\n         └─ winapp get-winapp-path (or --global for shared cache)\n```\n\n**Important notes:**\n- `winapp init` adds files to an **existing** project — it does not create a new project\n- The key prerequisite for most commands is `Package.appxmanifest`, not `winapp.yaml`\n- `winapp.yaml` is only needed for SDK version management (`restore`\u002F`update`)\n- Projects with NuGet package references (e.g., `.csproj` referencing `Microsoft.Windows.SDK.BuildTools`) can use winapp commands without `winapp.yaml`\n- For Electron projects, use the npm package (`npm install --save-dev @microsoft\u002Fwinappcli`) which includes Node.js-specific commands under `npx winapp node`\n\n## Debugging approach quick reference\n\n| Goal | Command | Key detail |\n|------|---------|------------|\n| Run with identity (most common) | `winapp run .\\build\\Debug` | Registers loose layout + launches; a console app gets an execution alias automatically |\n| Attach debugger to running app | `winapp run .\\build\\Debug` → attach to PID | Misses startup code |\n| Register identity, launch manually | `winapp run .\\build\\Debug --no-launch` | Launch via `start shell:AppsFolder\\\u003CAUMID>` or execution alias — **not** the exe directly |\n| F5 startup debugging (IDE launches exe) | `winapp create-debug-identity .\\bin\\myapp.exe` | Exe has identity regardless of how it's launched; best for debugging activation\u002Fstartup code |\n| Capture OutputDebugString + crash dump | `winapp run .\\build\\Debug --debug-output` | On crash, writes minidump and shows exception type, message, and faulting methods. **Blocks other debuggers** — use `--no-launch` if you need VS Code\u002FWinDbg |\n| Run and auto-clean | `winapp run .\\build\\Debug --unregister-on-exit` | Unregisters the dev package after the app exits |\n| Launch and detach (CI) | `winapp run .\\build\\Debug --detach` | Returns immediately after launch; use `--json` to get PID for scripting |\n| Clean up this app's registration | `winapp unregister .` | Pass the same input as `run`; works with or without `--unique-identity` |\n| Start menu entry does nothing when clicked | `winapp unregister --prune` | The package is registered but its files were deleted, so activation silently fails. Prune removes every dev registration whose files are gone |\n\n> **Visual Studio users:** If you have a packaging project, VS already handles identity and debugging from F5 — you likely don't need winapp for debugging. These workflows are for VS Code, terminal, and frameworks VS doesn't natively package.\n\nFor full details, see the [Debugging Guide](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fdebugging.md).\n\n## Prerequisites & state matrix\n\n| Command | Requires | Creates\u002FModifies |\n|---------|----------|------------------|\n| `init` | Existing project (any framework) | `winapp.yaml`, `.winapp\u002F`, `Package.appxmanifest`, `Assets\u002F`, `.gitignore` update |\n| `restore` | `winapp.yaml` | `.winapp\u002Fpackages\u002F`, generated projections |\n| `update` | `winapp.yaml` | Updates versions in `winapp.yaml`, reinstalls packages |\n| `manifest generate` | Nothing | `Package.appxmanifest`, `Assets\u002F` |\n| `manifest update-assets` | `Package.appxmanifest` + source image | Regenerates `Assets\u002F` icons |\n| `cert generate` | Nothing (or `Package.appxmanifest` for publisher) | `devcert.pfx` |\n| `cert install` | Certificate file + admin | Machine certificate store |\n| `create-debug-identity` | `Package.appxmanifest` + exe + trusted cert | Registers sparse package with Windows |\n| `run` | Build output folder + `Package.appxmanifest`; **or** a `.csproj`\u002F`.vcxproj`\u002F`.sln` (C++ needs Visual Studio or Build Tools with the C++ workload); **or** a `.cs` file-based app (no manifest needed — one is generated) | Registers loose layout package, launches app |\n| `unregister` | The same input passed to `run` (`.cs`, `.csproj`\u002F`.vcxproj`, or folder), or `--manifest` | Removes the development registration that `run` or `create-debug-identity` created |\n| `package` | Build output + `Package.appxmanifest` | `.msix` file |\n| `sign` | File + certificate | Signed file (in-place) |\n| `create-external-catalog` | Directory with executables | `CodeIntegrityExternal.cat` |\n| `tool \u003Cname>` | Nothing (auto-downloads tools) | Runs SDK tool directly |\n| `store` | Nothing (auto-downloads Store CLI) | Passthrough to Microsoft Store Developer CLI |\n| `get-winapp-path` | Nothing | Prints `.winapp` directory path |\n\n## Debugging tips\n\n- Add `--verbose` (or `-v`) to any command for detailed output\n- Add `--quiet` (or `-q`) to suppress progress messages (useful in CI\u002FCD)\n- Run `winapp --cli-schema` to get the full JSON schema of all commands and options\n- Run any command with `--help` for its specific usage information\n- Use `winapp get-winapp-path` to find where packages are stored locally\n- Use `winapp get-winapp-path --global` to find the shared cache location\n\n## Getting more help\n\n- Full CLI documentation: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fblob\u002Fmain\u002Fdocs\u002Fusage.md\n- Framework-specific guides: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Ftree\u002Fmain\u002Fdocs\u002Fguides\n- File an issue: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FWinAppCli\u002Fissues\n\n## Related skills\n- **Setup & init**: `winapp-setup` — adding Windows support to a project\n- **Manifest**: `winapp-manifest` — creating and editing `Package.appxmanifest`\n- **Signing**: `winapp-signing` — certificate generation and management\n- **Packaging**: `winapp-package` — creating MSIX installers\n- **Identity**: `winapp-identity` — enabling package identity for Windows APIs\n- **Frameworks**: `winapp-frameworks` — framework-specific guidance (Electron, .NET, C++, Rust, Flutter, Tauri)\n- **MAUI**: `winapp-maui` — packaging\u002Fsigning .NET MAUI Windows apps and resolving the resizetizer manifest\n\n## CLI reference\n\nRun `winapp \u003Ccommand> --help` for current command options, or `winapp --cli-schema` for the complete machine-readable command schema.\n",{"name":5,"description":7},"main","886c8edcdc7ca26e1e2947a12d81a91d6a9334a5","plugins\u002Fwinapp\u002Fskills\u002Fwinapp-troubleshoot",96,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-14 07:14:37",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add microsoft\u002FwinappCli --skill winapp-troubleshoot",{"tool":60,"command":61},"bunx","bunx skills add microsoft\u002FwinappCli --skill winapp-troubleshoot",{"tool":63,"command":64},"pnpm","pnpm dlx skills add microsoft\u002FwinappCli --skill winapp-troubleshoot","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinapp\u002Fskills\u002Fwinapp-troubleshoot\u002FSKILL.md",true,[],[69,90,124,147,166,181],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":40},"01M699M75MK9AADQV8PQQQ6NEV","winui-wpf-migration","Migrate or port a WPF app to WinUI 3: namespaces (System.Windows to Microsoft.UI.Xaml), control mapping (DataGrid, WrapPanel, TabControl), Dispatcher to DispatcherQueue, imaging, MVVM with CommunityToolkit.Mvvm, ThemeResource. Use when converting WPF code or fixing migration build errors.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinui\u002Fagent-plugin\u002Fskills\u002Fwinui-wpf-migration\u002FSKILL.md",[],[76,77,78,79,9,39,80,27,81,82,83,84,28,85,35,86,87,88,31,89,21],"winui wpf migration","winui","wpf","migration","dispatcher","xaml","ui","migrate","system","mvvm","mapping","port","imaging","namespaces",{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":106,"publishedAt":40},"01M699M4W3GKSVVT9CRR1E3KSW","winui-ui-testing","Write and run automated UI tests for Windows desktop apps (WinUI 3, WPF, WinForms, Win32) with the winapp ui harness: one batch script, assertions, input, file pickers, dialogs, screenshots, locally or in Windows Sandbox. Use when asked for UI tests or to verify a feature end to end.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinui\u002Fagent-plugin\u002Fskills\u002Fwinui-ui-testing\u002FSKILL.md",[96,101],{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",{"categoryNo":102,"categoryName":103,"taxonomyType":104,"taxonomyTypeDesc":105},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[107,108,77,82,109,110,111,39,112,113,114,115,116,117,118,119,120,121,122,123,21],"testing","winui ui testing","ui testing","screenshots","sandbox","run","win32","harness","batch","write","feature","end","apps","input","winforms","desktop apps","for",{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":133,"publishedAt":40},"01M699M2KTEYJZBDW7JBHM94K0","winui-setup","Install and verify WinUI 3 prerequisites — .NET SDK 8.0.100+, WinApp CLI 0.7+, and Developer Mode; identify additional Native AOT and Windows Sandbox requirements. Use when the user asks to set up or repair the toolchain, or when another WinUI skill finds a missing or outdated prerequisite.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinui\u002Fagent-plugin\u002Fskills\u002Fwinui-setup\u002FSKILL.md",[130],{"categoryNo":131,"categoryName":132,"taxonomyType":104,"taxonomyTypeDesc":105},"01JBSEEDCAT000000000000030","开发工程师",[134,135,77,136,111,38,39,137,138,22,28,139,140,141,142,143,144,145,146,21],"winui setup","setup","cli","SET","verify","up","repair","requirements","missing","native","toolchain","winapp cli","mode",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":156,"publishedAt":40},"01M699KZWEZ84A4J3291E6R65B","winui-packaging","MSIX packaging, signing, and Microsoft Store publishing for WinUI 3 apps with WinApp CLI 0.7+: project packaging, Native AOT, certificates, self-contained deployment, CI\u002FCD. Use when releasing or publishing a WinUI app. Not for WPF, WinForms, or Electron apps that only reference the Windows App SDK.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinui\u002Fagent-plugin\u002Fskills\u002Fwinui-packaging\u002FSKILL.md",[153],{"categoryNo":154,"categoryName":155,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000011","运维与部署",[157,77,32,136,38,158,9,159,39,160,161,25,162,163,164,35,119,121,143,165,145,123,21],"winui packaging","electron","msix","windows app sdk","ci","only","self","project","CI\u002FCD",{"skillNo":167,"name":168,"nameZh":6,"description":169,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":170,"categories":171,"keywords":172,"publishedAt":40},"01M699KXTHG9FHK4X3JSZ4SV8J","winui-dev-workflow","Create, build, run, and fix build errors in WinUI 3 apps (C# or C++) with WinApp CLI 0.7+: winapp new, winapp run, Native AOT, crash diagnosis. Use for a new WinUI app or a WinUI project that fails to build or crashes. Not for WPF, WinForms, or Electron apps that only reference the Windows App SDK.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinui\u002Fagent-plugin\u002Fskills\u002Fwinui-dev-workflow\u002FSKILL.md",[],[173,174,77,175,176,136,38,158,39,177,112,178,162,164,35,179,119,121,143,145,31,180],"workflow","winui dev workflow","dev","dev workflow","create","fix","diagnosis","new",{"skillNo":182,"name":183,"nameZh":6,"description":184,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":185,"categories":186,"keywords":197,"publishedAt":40},"01M699KV0Q6NE5EET5EDBH33NM","winui-design","Read before writing or changing WinUI 3 XAML: choosing controls, pages and navigation, layout, Fluent Design, theming, accessibility, x:Bind, real samples, and checking that APIs exist with winapp find-api. Not for WPF or WinForms UI, even if the app uses the Windows App SDK.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FwinappCli\u002Fblob\u002Fmain\u002Fplugins\u002Fwinui\u002Fagent-plugin\u002Fskills\u002Fwinui-design\u002FSKILL.md",[187,190,193,194],{"categoryNo":188,"categoryName":189,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":191,"categoryName":192,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":102,"categoryName":103,"taxonomyType":104,"taxonomyTypeDesc":105},{"categoryNo":195,"categoryName":196,"taxonomyType":104,"taxonomyTypeDesc":105},"01JBSEEDCAT000000000000036","内容创作者",[198,199,77,200,38,201,202,39,160,78,81,82,203,204,205,206,207,35,121,208,123,209],"design","winui design","writing","accessibility","fluent","api","read","layout","pages","bind","controls","fluent design"]