binlog-failure-analysis

Diagnose MSBuild build failures by querying binary log files through MCP tools.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/Netcodr81/kinetic-reports --skill binlog-failure-analysis-netcodr81
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: binlog-failure-analysis
Source: https://github.com/Netcodr81/kinetic-reports/tree/main/.github/skills/binlog-failure-analysis
Command: npx skills add https://github.com/Netcodr81/kinetic-reports --skill binlog-failure-analysis-netcodr81

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? MSBuild build failures often produce console output that is too terse or too noisy to explain the root cause, especially in multi-project builds with cascading errors. This Skill analyzes an existing .binlog file to trace errors, warnings, properties, and target execution without manual log digging. ## Core Features & Use Cases - Structured binlog querying: Uses the binlog MCP server (Microsoft.AITools.BinlogMcp) to inspect errors, warnings, MSBuild properties, items, project evaluation data, and target execution details. - Embedded file retrieval: Reads project files (.csproj, .props, .targets) embedded in the binlog even when sources are not available on disk. - Fallback text replay: Replays the binlog to diagnostic, errors-only, and warnings-only text logs via dotnet msbuild when the MCP server is unavailable. - Use Case: A CI build fails with a vague CS0246 error across several projects. Point the Skill at the captured build.binlog to identify which project failed, which target ran, and what property values caused the failure. ## Quick Start Analyze the attached build.binlog file and explain why the MSBuild build failed, including the failing project, target, and root-cause error.

Frequently Asked Questions about binlog-failure-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze an MSBuild binlog file for build errors?▼

Use the binlog MCP server tools to query the .binlog for errors, warnings, properties, and target execution details. The file is binary, so never read it with cat or strings; query it through the MCP tools or replay it to text logs with dotnet msbuild.

How to generate a binlog file for MSBuild diagnostics?▼

Run dotnet build with the /bl:build.binlog flag to produce a binary log during the build. This Skill focuses on analyzing an existing binlog; generation is only a fallback step when no binlog exists yet.

Can I read a .binlog file directly as text?▼

No, the .binlog format is binary and cannot be inspected with cat, head, or strings. Use the binlog MCP tools, or replay it to text logs with dotnet msbuild -fl -flp:v=diag options when the MCP server is unavailable.

What if the binlog MCP server is not available?▼

Fall back to the text-log replay workflow: run dotnet msbuild build.binlog with file logger parameters to produce full.log, errors.log, and warnings.log, then search them with grep for error codes and failing targets.

Can I inspect project files that are missing from disk?▼

Yes, project files such as .csproj, .props, and .targets are embedded in the binlog and can be retrieved through the MCP server's source file retrieval tools even when they no longer exist on disk.