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"
      }
    }
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

    external-pluginPublic external plugin submissionready-for-reviewSubmission passed intake validation and is ready for maintainer review

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions