winapp-package

Package built Windows app directories into MSIX installers with optional signing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Packaging Windows applications into distributable MSIX installers is complex, requiring manifest handling, certificate management, and accurate packaging layouts.

Core Features & Use Cases

  • Locate Package.appxmanifest from the input build folder or current directory.
  • Assemble staging layout, copy assets, generate resources pri, and package with makeappx.
  • Sign the package with a certificate (optional) and optionally bundle the Windows App SDK for self-contained deployment.

Quick Start

Package a built app directory by running winapp package <build-output> to create an MSIX package.

Frequently Asked Questions about winapp-package

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

FAQPage Schema
How do I package a built Windows app into an MSIX installer for distribution?

To package a Windows app into an MSIX installer, provide a built app directory containing a Package.appxmanifest. The tool stages assets, generates resources, and uses makeappx to output the final MSIX package.

What is MSIX packaging and when do I need it for my Windows application?

MSIX packaging is a Windows deployment format that wraps GUI, console, or CLI apps into distributable installers. You need it to simplify installation, updates, and testing for your Windows applications.

Can I sign an MSIX package with a certificate during the build process?

Yes, you can sign an MSIX package by providing an optional certificate via the --cert parameter. This allows you to sign the package directly during the assembly and packaging process.

Does MSIX packaging work with console apps and CLI tools or just GUI applications?

MSIX packaging works with GUI applications, console apps, and CLI tools. It assembles the staging layout from your build output directory to produce a complete package for any of these app types.

Do I need to bundle the Windows App SDK for a self-contained MSIX deployment?

You can optionally bundle the Windows App SDK within the MSIX packaging layout. This enables a self-contained deployment, ensuring the necessary framework dependencies travel with your installer.

What is the best way to handle Package.appxmanifest when generating an MSIX file?

The best way to handle Package.appxmanifest is to place it in your input build folder or current directory. The packaging process automatically locates it to assemble the staging layout and generate the MSIX file.