Skip to content

[Skill] WinUI runtime error diagnostics #127

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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions