microsoft / microsoft/win-dev-skills

[Skill] WinUI runtime error diagnostics

Open
#127 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C#
Stars
444
Forks
33
Avg merge
2h 59m
Merged PRs (30d)
11

Description

Parent: #126

Summary

A guidance skill that teaches an agent to diagnose the most common WinUI 3 / Windows App SDK runtime errors — symptom → root cause → fix — so it stops guessing. Complements the WinDbg skill for dump cases.

Target error classes (most-common, verified)

  • COMException 0x80040154 (REGDB_E_CLASSNOTREG, "Class not registered") — usually missing package identity or Windows App SDK runtime.
  • Wrong-thread marshalling — RPC_E_WRONG_THREAD (0x8001010E) — touching UI off the DispatcherQueue; guide to DispatcherQueue.TryEnqueue.
  • Bootstrapper / runtime-not-found — unpackaged apps missing Bootstrap.Initialize() / mismatched runtime version.
  • XAML parse / binding errorsx:Bind failures, missing StaticResource, XamlParseException.

What the skill should teach the agent

  • How to recognize each symptom from build/run logs and error text.
  • How to decode HRESULT / NTSTATUS / GetLastError (facility/severity bits) to meaning.
  • A checklist + concrete fix per class (packaged vs unpackaged, dispatcher marshalling, runtime install, XAML resource resolution).

Deliverables

  • Skill (SKILL.md + supporting guidance files) under plugins/.
  • Worked examples for each error class.

References

  • Windows App SDK known issues; packaged vs unpackaged deployment docs.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the Windows App SDK known-issues material and the packaged versus unpackaged deployment docs referenced in the issue. Add the skill under plugins/, including SKILL.md, supporting guidance, and worked examples for each listed error class. Done means the guidance covers symptom recognition, cause, decoding, and a concrete fix for all four classes.

Written by the indexing model from the issue text.

Assessment

Domain
devtools, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.