dotnet-windbg-debugging

name	dotnet-windbg-debugging
description	Debugs Windows apps via WinDbg MCP. Crash, hang, high-CPU, and memory triage from dumps or live attach.
license	MIT
targets	["*"]
tags	["foundation","dotnet","skill"]
version	0.0.1
author	dotnet-agent-harness
claudecode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}
codexcli	{"short-description":".NET skill guidance for foundation tasks"}
opencode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}

dotnet-windbg-debugging

Windows user-mode debugging using WinDbg MCP tools. Applicable to any Windows application -- native, managed (.NET/CLR), or mixed-mode. Guides investigation of crash dumps, application hangs, high CPU, and memory pressure through structured command packs and report templates.

Platform: Windows only.

Scope

• Crash dump analysis (.dmp files) for any Windows process (native, .NET, or mixed-mode)
• Live process attach via cdb debug server
• Hang and deadlock diagnosis (thread analysis, lock detection)
• High CPU triage (runaway thread identification)
• Memory pressure and leak investigation via native heap analysis
• Kernel dump triage (BSOD / bugcheck analysis)
• COM/RPC wait chain and UI message pump analysis
• Structured diagnostic reports with stack evidence

Out of scope

• .NET SDK diagnostic tools (dotnet-counters, dotnet-trace, dotnet-dump) -- see [skill:dotnet-profiling]
• GC tuning and managed memory optimization -- see [skill:dotnet-gc-memory]
• Performance benchmarking and regression detection -- see [skill:dotnet-benchmarkdotnet]
• Application performance architecture patterns -- see [skill:dotnet-performance-patterns]

MCP Tool Contract

Use these mcp-windbg operations:

1. mcp_mcp-windbg_open_windbg_remote -- attach to a live debug server
2. mcp_mcp-windbg_open_windbg_dump -- open a saved dump file
3. mcp_mcp-windbg_run_windbg_cmd -- execute debugger commands
4. mcp_mcp-windbg_close_windbg_remote -- detach from live session
5. mcp_mcp-windbg_close_windbg_dump -- close dump session

Quick Start

1. Configure and access MCP: see reference/access-mcp.md
2. Choose workflow:
   • Live attach: see reference/live-attach.md
   • Dump analysis: see reference/dump-workflow.md
3. Choose a task reference: see reference/scenario-command-packs.md
4. Use support references as needed:
   • Sanity check: reference/sanity-check.md
   • Symbols: reference/symbols.md
   • Common patterns: reference/common-patterns.md
   • Capture playbooks: