A skill covering the main APIs in the official documentation for app lifecycle, window management, notifications, resource management, widgets, and deployment in WinUI 3 / Windows App SDK. Depending on the user's task, read the appropriate README.md and follow it to the individual files.
Directory structure
skills/windows-app-sdk/
SKILL.md
references/
lifecycle/
README.md
application.md
app-instance.md
app-activation-arguments.md
rich-activation.md
single-instancing.md
power-manager.md
focus-session.md
app-restore.md
windowing/
README.md
windowing-overview.md
app-window.md
app-window-presenter.md
overlapped-presenter.md
compact-overlay-presenter.md
full-screen-presenter.md
app-window-titlebar.md
title-bar-customization.md
display-area.md
display-area-watcher.md
window-id.md
xaml-window.md
win32-interop.md
multiple-windows.md
notifications/
README.md
app-notification-manager.md
app-notification.md
app-notification-builder.md
app-notification-activated-event-args.md
toast-content-schema.md
push-notification-manager.md
push-notification-channel.md
push-notification-received-event-args.md
badge-notifications.md
app-notification-collections.md
notification-listener.md
app-notification-scheduled.md
resources-mrt/
README.md
resource-manager.md
resource-context.md
resource-map.md
resource-candidate.md
resource-loader.md
resource-qualifiers.md
resources-pri-makepri.md
localize-strings.md
dwritecore.md
widgets/
README.md
iwidgetprovider.md
iwidgetprovider2.md
widgetmanager.md
widgetcontext.md
widgetinfo.md
widgetupdaterequestoptions.md
widget-provider-manifest.md
implement-widget-provider.md
widgets-create-a-template.md
widget-header-customization.md
feed-provider-manifest.md
feedmanager.md
ifeedprovider.md
implement-feed-provider.md
web-widget-providers.md
widget-provider-activateapplication-protocol.md
widget-provider-error-analytics-reporting.md
deployment-versioning/
README.md
deployment-architecture.md
deploy-overview.md
deploy-packaged-apps.md
deploy-unpackaged-apps.md
deploy-self-contained-apps.md
release-channels.md
downloads.md
system-requirements.md
project-properties.md
use-windows-app-sdk-run-time.md
tutorial-unpackaged-deployment.md
deploymentmanager.md
deploymentresult.md
check-windows-app-sdk-versions.md
single-project-msix.md
remove-windows-app-sdk-versions.md
packagedependency.md
packagedeploymentmanager.md
runtimecompatibilityoptions.md
runtimeinfo.md
Exploration procedure
Derive the category from the task, and identify the target page in the category's README.md:
- Find the category corresponding to the task in the mapping table below
- For that category,
references/{category}/README.mdto identify the target page - Read the
.mdof the relevant page to check the details
Task → Category Mapping
| Task | Category | Reference README |
|---|---|---|
| I want to control multiple launches of an app using AppInstance / single instancing | lifecycle | references/lifecycle/README.md |
| I want to handle file, protocol, and shortcut activation using RichActivation / AppActivationArguments | lifecycle | references/lifecycle/README.md |
| I want to monitor power state and battery state using PowerManager | lifecycle | references/lifecycle/README.md |
| I want to control window display, size, and state using AppWindow / AppWindowPresenter | windowing | references/windowing/README.md |
| I want to customize the title bar (AppWindowTitleBar, custom title bar) | windowing | references/windowing/README.md |
| I want to do window placement and HWND interop using DisplayArea / multi-window / Win32 interop | windowing | references/windowing/README.md |
| I want to display local notifications using AppNotification / Toast | notifications | references/notifications/README.md |
| I want to implement push notifications using PushNotificationManager / PushNotificationChannel | notifications | references/notifications/README.md |
| I want to handle badge notifications and event arguments on toast activation | notifications | references/notifications/README.md |
| I want to manage app resources using ResourceManager / MRT / PRI resources | resources-mrt | references/resources-mrt/README.md |
| I want to handle multilingual localization of strings and images, and resource qualifiers | resources-mrt | references/resources-mrt/README.md |
| I want to generate resource packages using makepri | resources-mrt | references/resources-mrt/README.md |
| I want to implement WidgetProvider to create widgets compatible with the widget board | widgets | references/widgets/README.md |
| I want to update widgets and manage their state using WidgetManager / WidgetInfo | widgets | references/widgets/README.md |
| I want to create widget UI using adaptive card templates | widgets | references/widgets/README.md |
| I want to distribute apps using MSIX package deployment / self-contained deployment | deployment-versioning | references/deployment-versioning/README.md |
| I want to handle runtime initialization and updates using DeploymentManager / DeploymentResult | deployment-versioning | references/deployment-versioning/README.md |
| I want to check release channels, system requirements, and project properties | deployment-versioning | references/deployment-versioning/README.md |
WinUI 3 controls (XAML UI components such as Button / Grid / NavigationView / TextBox) are outside the scope of this skill and are handled by another skill. This skill is limited to Windows App SDK-specific runtime APIs such as app lifecycle, window management, notifications, resources, widgets, and deployment. Do not confuse it with apple-swiftui / ark-ui / chakra-ui / fandhe-frontend / android-compose-*, which have APIs with the same names but target different platforms.