windbg-diagnostic-method

windbg-diagnostic-method is a skill for Claude Code from microsoft/win-dev-skills. It costs 42 tokens per session (1,730 once invoked), scanned A, original, MIT.

A method for investigating Windows failures with evidence before conclusions. It explains how to weigh dump files, symbols, traces, reproductions, and missing information when using WinDbg.

In plain words
What is it for?
Use it to structure crash, hang, and leak investigations, compare alternative causes, calibrate confidence, and check that the final report is supported by evidence.
Why use it?
It reduces the risk of treating a familiar crash pattern as proof or blaming the module where the failure appeared. It also helps state uncertainty and avoid claiming access to tools or files that were not available.

Skill for Claude Code ✓ vendor

Written for Claude Code: user-invocable in frontmatter.

Part of the windbg plugin — 11 skills, 2 agents shipped together

Good fit Use it to structure crash, hang, and leak investigations, compare alternative causes, calibrate confidence, and check that the final report is supported by evidence.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/microsoft/win-dev-skills/windbg-diagnostic-method
About the project

microsoft/win-dev-skills is a collection of AI-agent instructions and tools for creating native Windows applications with WinUI 3 and the Windows App SDK. Windows developers use it to guide agents through app development tasks from scaffolding and design to testing, packaging, and release. The catalogue entries are its agents, skills, and plugin components.

microsoft/win-dev-skills · 472 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add microsoft/win-dev-skills --skill windbg-diagnostic-method
Clone the repo
git clone --depth 1 https://github.com/microsoft/win-dev-skills

Made for: Claude Code.

Or install windbg, the plugin that ships this one along with the rest of its 11 skills, 2 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for windbg-diagnostic-method

README.md
[![agentmods](https://agentmods.dev/badge/skills/microsoft/win-dev-skills/windbg-diagnostic-method/github.svg)](https://agentmods.dev/skills/microsoft/win-dev-skills/windbg-diagnostic-method)
Your own site
<a href="https://agentmods.dev/skills/microsoft/win-dev-skills/windbg-diagnostic-method"><img src="https://agentmods.dev/badge/skills/microsoft/win-dev-skills/windbg-diagnostic-method/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for windbg-diagnostic-method

Your own site · 80×15
<a href="https://agentmods.dev/skills/microsoft/win-dev-skills/windbg-diagnostic-method"><img src="https://agentmods.dev/badge/skills/microsoft/win-dev-skills/windbg-diagnostic-method.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 42 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,730 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00042 $0.01730
Opus 5.5 $0.00017 $0.00692
Sonnet 5.5 $0.00008 $0.00346
Haiku 4.5 $0.00004 $0.00173

Measured 8d ago against content hash d5d248c3f877, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

windbg-diagnostic-method scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/validate-diagnosis-output.ps1), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/windbg/skills/windbg-diagnostic-method/SKILL.md · 180 lines

How it starts

The opening of the file, as written. The whole thing — 180 lines — stays where its author put it; the contents beside it link to each section on GitHub.

WinDbg Diagnostic Method

Apply this method alongside the bug-family-specific skill selected for an investigation. Pattern matches route the investigation; they do not prove the root cause.

Evidence ladder

Prefer direct evidence in this order:

  1. Faulting instruction/context, bugcheck or exception parameters, and resource owners/waiters from the actual dump or trace.
  2. Matching symbols and the user's authorized source for the involved build.
  3. Allocation/free, Verifier, IRP, lock, ETW, WCT, or TTD history captured for the same failure.
  4. Controlled reproduction and instrumentation.
  5. Pattern guidance as a hypothesis only.

Never claim commands, source access, or artifacts that are unavailable in the session.

First-pass normalization

  • Confirm process dump versus kernel dump and target architecture/build.
  • Load public Windows symbols and matching symbols for user/vendor modules.
  • Record missing pages, symbols, related-process dumps, trace scope, and tool availability.
  • User-mode exception: .exr -1, .ecxr, stack, and registers.
  • Kernel bugcheck: .bugcheck, !analyze -v, then documented context/trap recovery for that code.
  • Hang: identify the affected operation, wait type, owner/server, and deepest supported blocker.
  • Memory: distinguish corruption, address-space pressure, and commit/limit failures before choosing a fix.

Five-phase investigation

  1. OBSERVE: establish dump/trace type, architecture, symbols, code, stack, registers, thread/resource state, and missing evidence.
  2. HYPOTHESIZE: form a specific primary mechanism and at least two plausible alternatives when the evidence permits.
  3. TEST: identify direct debugger, source, trace, or reproduction evidence that distinguishes the hypotheses. Absence of evidence is not evidence of absence.
  4. EVALUATE: record supporting, contradictory, and missing evidence.
  5. CONCLUDE or PIVOT: name the violated invariant and verification plan, or remain candidate-pending-verification.

Read the full file on GitHub · 180 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 180 lines · 42 tokens per session scan A d5d248c3f877

Subscribe to this mod's changes

windbg-diagnostic-method is a skill published in the GitHub repository microsoft/win-dev-skills (472 stars, last pushed 2d ago), licensed MIT. It adds 42 tokens to every session and 1,730 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-08.

Related

Other skills, from other repositories

component-flattening-analysis

Detects misplaced classes and fixes component hierarchy problems — finds code that should belong inside a component but sits at the root level. Use when asking "clean up component structure", "find orphaned classes", "fix module hierarchy", "flatten nested components", or analyzing why namespaces have misplaced code.…

tech-leads-club/agent-skills · 86 tokens

codenavi

Your pathfinder for navigating unknown codebases. Investigates with precision, implements surgically, and never assumes — if it doesn't know, it says so. Maintains a .notebook/ knowledge base that grows across sessions, turning every discovery into lasting intelligence. Summons available skills, MCPs, and docs when…

tech-leads-club/agent-skills · 139 tokens

chrome-devtools

Browser debugging, performance profiling, and automation via Chrome DevTools MCP. Use when user says "debug this page", "take a screenshot", "check network requests", "profile performance", "inspect console errors", or "analyze page load". Do NOT use for full E2E test suites (use playwright-skill) or non-browser…

tech-leads-club/agent-skills · 74 tokens

sentry

Inspect Sentry issues, summarize production errors, and pull health data via the Sentry API (read-only). Use when user says "check Sentry", "what errors in production?", "summarize Sentry issues", "recent crashes", or "production error report". Requires SENTRYAUTHTOKEN. Do NOT use for setting up Sentry SDK…

tech-leads-club/agent-skills · 84 tokens

chrome-devtools-mcp

Use Chrome DevTools MCP from .NET agents and .NET-focused repos to inspect, debug, and automate Chrome through an MCP client. USE FOR: the repo needs browser-level debugging for ASP.NET Core, Blazor, WebAssembly, or any .NET app with a web UI; the user wants an MCP server that can inspect console. DO NOT USE FOR: pure…

managedcode/dotnet-skills · 130 tokens

managedcode-orleans-graph

Integrate ManagedCode.Orleans.Graph into an Orleans-based .NET application for grain-call policy enforcement, deadlock detection, live-call telemetry, and Mermaid graph diagnostics. USE FOR: ManagedCode.Orleans.Graph integration; allowed grain transitions; Orleans call filters; live policy graphs; reviewing Orleans…

managedcode/dotnet-skills · 114 tokens