winapp-identity

Register sparse Windows package identity for desktop apps using Add-AppxPackage -ExternalLocation.

1.2k|68|Updated Jul 30, 2025
One-click install
npx skills add https://github.com/microsoft/winappCli --skill winapp-identity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: winapp-identity
Source: https://github.com/microsoft/winappCli/tree/main/.github/plugin/skills/winapp-cli/identity
Command: npx skills add https://github.com/microsoft/winappCli --skill winapp-identity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable Windows package identity for desktop apps to access Windows APIs like push notifications, background tasks, share target, and startup tasks.

Core Features & Use Cases

  • Enables identity for debugging and development by registering a sparse MSIX identity for a standalone executable without copying files.
  • Supports Electron and other frameworks where the exe is separate from the build output; ideal for testing identity-related features.
  • Provides guidance on when to use it versus full MSIX packaging and how to re-run identity registration after changes.

Quick Start

Use winapp create-debug-identity <path-to-exe> to register a temporary identity for debugging.

Frequently Asked Questions about winapp-identity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable Windows package identity for a desktop app during debugging?

To enable Windows package identity for debugging, register a sparse MSIX package using a temporary layout and Add-AppxPackage -ExternalLocation against your standalone executable without copying build files.

Can I get Windows package identity for an Electron app without full MSIX packaging?

Yes, you can register a temporary sparse identity for Electron apps where the exe is separate from build output, allowing you to test identity-requiring APIs without committing to full MSIX packaging.

What Windows APIs require package identity for desktop apps?

Windows APIs that require package identity for desktop apps include push notifications, background tasks, share target, and startup tasks, which are enabled by registering a sparse MSIX identity.

What's the best way to test startup task identity features for a standalone Windows executable?

The best way to test startup task identity for a standalone executable is registering a temporary sparse package that reads the manifest and applies identity using Add-AppxPackage -ExternalLocation.

Do I need to re-run identity registration after changing my desktop app manifest?

Yes, you must re-run the identity registration process after manifest changes to update the temporary sparse package layout and ensure your Windows identity-requiring APIs function correctly during development.

When should I use a sparse package identity versus full MSIX packaging for my Windows app?

Use a sparse package identity for development and debugging to test APIs without copying files, whereas full MSIX packaging is suited for final deployment and distribution of your Windows application.