AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

winui-app

Bootstrap, develop, and design modern WinUI 3 desktop applications with C# and the Windows App SDK using official Microsoft guidance, WinUI Gallery patterns, Windows App SDK samples, and CommunityToolkit components. Use when creating a brand new app, preparing a machine for WinUI, reviewing, refactoring, planning, troubleshooting, environment-checking, or setting up WinUI 3 XAML, controls, navigation, windowing, theming, accessibility, responsiveness, performance, deployment, or related Windows app design and development work.

Original source
openai
License
Apache-2.0
Pinned revision
49f948faa9258a0c61caceaf225e179651397431

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read openai--winui-app at revision 49f948faa9258a0c61caceaf225e179651397431, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 18

references/_sections.md

Reference Sections

Use this index to choose the narrowest reference file that fits the current task.

1. Foundations

  • foundation-setup-and-project-selection.md

    • Priority: CRITICAL
    • Use for first-project setup, packaged vs unpackaged decisions, and core WinUI prerequisites.
    • Authority: Microsoft Learn WinUI and Windows App SDK setup docs.
  • foundation-environment-audit-and-remediation.md

    • Priority: CRITICAL
    • Use for machine readiness checks, missing prerequisites, and guided remediation.
    • Authority: Microsoft Learn setup and system requirements docs, plus the bundled bootstrap workflow.
  • foundation-winui-app-structure.md

    • Priority: HIGH
    • Use for solution layout, shell composition, resources, bindings, and C#-first project structure.
    • Authority: WinUI Gallery source plus Learn XAML guidance.
  • foundation-template-first-recovery.md

    • Priority: CRITICAL
    • Use for opaque MSB3073, XamlCompiler.exe, and startup failures that should be recovered by comparing against a fresh dotnet new winui scaffold instead of applying alternate baseline files.
    • Authority: Learn packaged and unpackaged deployment guidance plus recurring template-first recovery patterns.
  • build-run-and-launch-verification.md

    • Priority: CRITICAL
    • Use for build/run workflows, actual launch verification, startup crashes, and packaged-vs-unpackaged local execution choices.
    • Authority: Learn setup and deployment guidance plus recurring WinUI troubleshooting patterns.

2. Shell, Navigation, and Windowing

  • shell-navigation-and-windowing.md
    • Priority: HIGH
    • Use for NavigationView, page shells, title bars, AppWindow, and multi-window design.
    • Authority: Learn design guidance, WinUI Gallery samples, Windows App SDK Windowing samples.

3. Controls, Layout, and Adaptive UI

  • controls-layout-and-adaptive-ui.md
    • Priority: HIGH
    • Use for control selection, command surfaces, responsive layout, and page composition.
    • Authority: Learn design guidance and WinUI Gallery control pages.

4. Styling, Theming, Materials, and Icons

  • styling-theming-materials-and-icons.md

    • Priority: HIGH
    • Use for Fluent styling, theme resources, Mica, Acrylic, typography, and iconography.
    • Authority: Learn design/material docs, WinUI Gallery backdrop samples, Windows App SDK Mica samples.
  • motion-animations-and-polish.md

    • Priority: MEDIUM
    • Use for transitions, connected animation, subtle polish, and animation discipline.
    • Authority: Learn motion guidance, WinUI Gallery transition samples, CommunityToolkit animations.

5. Accessibility, Input, and Localization

  • accessibility-input-and-localization.md
    • Priority: HIGH
    • Use for keyboarding, Narrator, high contrast, automation properties, and localization concerns.
    • Authority: Learn accessibility and globalization guidance, WinUI Gallery automation patterns.

6. Performance and Diagnostics

  • performance-diagnostics-and-responsiveness.md
    • Priority: HIGH
    • Use for UI-thread responsiveness, large item collections, rendering cost, and diagnostic tooling.
    • Authority: Learn WinUI performance docs and XAML frame analysis guidance.

7. Windows App SDK Scenarios

  • windows-app-sdk-lifecycle-notifications-and-deployment.md
    • Priority: HIGH
    • Use for lifecycle, activation, notifications, packaged vs unpackaged deployment, and runtime initialization.
    • Authority: Microsoft Learn Windows App SDK docs and WindowsAppSDK-Samples.

8. CommunityToolkit Extensions

  • community-toolkit-controls-and-helpers.md
    • Priority: MEDIUM
    • Use when built-in WinUI controls are not enough and Toolkit packages might close the gap cleanly.
    • Authority: CommunityToolkit/Windows packages and samples.

9. Testing, Debugging, and Review

  • testing-debugging-and-review-checklists.md

    • Priority: HIGH
    • Use for final review passes, debugging workflows, and validation checklists.
    • Authority: Learn tooling docs plus recurring WinUI review patterns.
  • sample-source-map.md

    • Priority: MEDIUM
    • Use when you need to know which canonical repo or doc to inspect first for a given task.
    • Authority: Curated map across Learn, WinUI Gallery, WindowsAppSDK-Samples, and CommunityToolkit.