Skip to content

[External Plugin]: windbg #4632

Description

@nmetulev

Plugin name

windbg

Short description

WinDbg diagnosis workflows for native Windows applications, services, UMDF/user-mode drivers, and kernel-mode drivers. Covers crashes, hangs, heap corruption, memory exhaustion, TTD, bugchecks, Driver Verifier, IRP lifecycle, and kernel deadlocks, with an evidence-first method and report validation.

GitHub repository

microsoft/win-dev-skills

Plugin path inside the repository

plugins/windbg

Ref to review

No response

Commit SHA to review

5ce74fa89c49ca353c6ab03bd5889aa519aa9e5e

Version

1.0.0

License identifier

MIT

Author name

Microsoft

Author URL

https://github.com/microsoft/WinDbg-Feedback

Homepage URL

https://github.com/microsoft/WinDbg-Feedback

Keywords

windows
windbg
debugging
crash-dump
hang
memory
drivers
kernel
umdf
ttd

Additional notes for reviewers

  • Agent Plugins 1.0 manifest with 11 skills: one shared windbg-diagnostic-method skill plus ten bug-family skills (windbg-user-*, windbg-kernel-*). It also includes two Copilot agents under com.github.copilot/agents/: diagnostician, and contrarian, an independent reviewer with no tools.
  • It doesn't bundle an MCP server or uploader. Debugger access comes from the user's existing WinDbg integration. State-changing steps (Verifier/Page Heap, trace capture) require explicit user authorization, and public feedback goes to microsoft/WinDbg-Feedback only after the user approves.
  • Also listed in the microsoft/win-dev-skills catalog: copilot plugin marketplace add microsoft/win-dev-skills then copilot plugin install windbg@win-dev-skills installs 11 skills. It also installs on Claude Code and Codex.
  • Before submitting, I ran this repo's validateExternalPlugin (both the marketplace and publicSubmission policies) and runExternalPluginQualityGates against this SHA. Spec compliance, vally lint (11/11), and version match passed.
  • Routing benchmark with Claude Sonnet 5 and GPT-5.5, run with and without winui, winappcli, and superpowers installed: the correct skill was selected on 34/34 runs of the 17 debugging prompts, and there were no false positives on the 8 non-debugging Windows/.NET prompts.
  • Source review: Add WinDbg diagnosis plugin microsoft/win-dev-skills#209

Submission checklist

  • The plugin lives in a public GitHub repository.
  • The ref and/or sha I provided is immutable (release tag and/or full 40-character commit SHA), not a branch.
  • This submission follows this repository's contribution, security, and responsible AI policies.
  • This plugin is not already listed in the Awesome Copilot marketplace.

Activity

  1. added
    external-pluginPublic external plugin submission
    ready-for-reviewSubmission passed intake validation and is ready for maintainer review
    on Oct 7, 2026
  2. github-actions commented on Oct 7, 2026

    @github-actions
    Contributor

    ✅ External plugin intake passed

    This submission passed automated intake validation and quality checks and is ready for maintainer review.

    View workflow run · Download full quality gate logs

    Reviewer signals

    These are non-blocking heuristics for maintainer review; they are not evidence of misconduct or low quality.

    Signal Result
    Repository age 218 day(s)
    Repository activity no configured signal
    Repository counts 462 stars · 2 watchers · 34 forks · 28 open issues/PRs
    Homepage heuristics ⚠️ pricing

    Quality gate summary

    Legend: ✅ pass · ⚠️ warning · 🛑 fail

    Gate Status
    spec compliance (non-blocking) ✅ pass
    vally lint ✅ pass
    install smoke test ✅ pass
    version match ✅ pass
    ref/sha consistency ⚪ not_run
    canvas structure ⚪ not_run
    • spec compliance: pass
    • vally lint: pass
    • install smoke test: pass
    • version match: pass
    • ref/sha consistency: not_run
    • canvas structure: not_run
    • overall: pass
    spec compliance output (✅ pass)
    Agent Plugins v1.0.0 manifest checks passed for plugin.json.
    
    vally lint output (✅ pass)
    ✅ windbg-diagnostic-method (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-kernel-bugcheck-triage (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-kernel-irp-lifecycle-triage (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-kernel-lock-deadlock-triage (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-kernel-verifier-triage (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-user-exception-triage (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-user-heap-corruption-investigation (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-user-mutex-held-across-co-await (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-user-ttd-reverse-debugging-triage (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-user-virtual-memory-exhaustion (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✅ windbg-user-wait-chain-analysis (2/2 checks passed)
        ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
            ✓ spec-compliance: All spec checks passed.
        ✓ [valid-refs] All file references across 1 skill(s) are valid.
            ✓ valid-refs: All file references resolve to existing files within the skill directory.
    
    11 skill(s) linted, 11 passed
    
    install smoke test output (✅ pass)
    Install smoke test succeeded. Verified /tmp/external-plugin-quality-CKyhSQ/copilot-home/.copilot/installed-plugins/external-plugin-intake/windbg/plugin.json.
    
    Version match output
    - 5ce74fa89c49ca353c6ab03bd5889aa519aa9e5e: matched version "1.0.0" at "plugins/windbg/plugin.json".
    
    Ref/SHA consistency output
    Ref/SHA consistency gate skipped because one of source.ref or source.sha was not provided.
    
    Canvas structure output
    Canvas structure gate skipped because plugin is not tagged with "canvas".
    

    Canonical external.json payload

    {
      "name": "windbg",
      "description": "WinDbg diagnosis workflows for native Windows applications, services, UMDF/user-mode drivers, and kernel-mode drivers. Covers crashes, hangs, heap corruption, memory exhaustion, TTD, bugchecks, Driver Verifier, IRP lifecycle, and kernel deadlocks, with an evidence-first method and report validation.",
      "version": "1.0.0",
      "author": {
        "name": "Microsoft",
        "url": "https://github.com/microsoft/WinDbg-Feedback"
      },
      "repository": "https://github.com/microsoft/win-dev-skills",
      "homepage": "https://github.com/microsoft/WinDbg-Feedback",
      "license": "MIT",
      "keywords": [
        "windows",
        "windbg",
        "debugging",
        "crash-dump",
        "hang",
        "memory",
        "drivers",
        "kernel",
        "umdf",
        "ttd"
      ],
      "source": {
        "source": "github",
        "repo": "microsoft/win-dev-skills",
        "path": "plugins/windbg",
        "sha": "5ce74fa89c49ca353c6ab03bd5889aa519aa9e5e"
      }
    }
  3. aaronpowell commented on Oct 12, 2026

    @aaronpowell
    Contributor

    /approve

  4. added
    approvedSubmission was approved by a maintainer
    and removed
    ready-for-reviewSubmission passed intake validation and is ready for maintainer review
    on Oct 12, 2026
  5. github-actions commented on Oct 12, 2026

    @github-actions
    Contributor

    ✅ External plugin approved

    A maintainer approved windbg, and the submission issue has been closed.

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

    approvedSubmission was approved by a maintainerexternal-pluginPublic external plugin submission

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions