binlog-failure-analysis

Diagnose MSBuild build failures by analyzing .binlog files for errors and target evidence.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill binlog-failure-analysis-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: binlog-failure-analysis
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/binlog-failure-analysis
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill binlog-failure-analysis-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosing MSBuild build failures becomes slow when the console output is unclear or when errors cascade across multiple projects and targets.

Core Features & Use Cases

  • Binary-log first analysis (preferred): Uses the binlog MCP tools to inspect a .binlog safely without trying to read the binary contents directly.
  • MSBuild evidence gathering: Extracts build errors/warnings, MSBuild properties, items (e.g., PackageReference, ProjectReference), target execution details, and embedded source file contents when needed.
  • Robust fallback workflow: Replays the binlog into diagnostic text logs and searches them with targeted patterns when the MCP server is unavailable.
  • Use Case: When a multi-project dotnet build fails with a misleading top-level error, analyze the .binlog to identify the actual failing target, the relevant project/inputs, and the underlying compilation or evaluation cause.

Quick Start

Ask the skill to analyze the provided build.binlog file and summarize the root cause of the failure with the most relevant MSBuild errors, targets, and properties.

Frequently Asked Questions about binlog-failure-analysis

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

FAQPage Schema
How do I diagnose MSBuild build failures from a .binlog file?

To diagnose MSBuild build failures from a .binlog file, the skill analyzes the binary log to extract underlying errors, warnings, and target execution evidence using structured MCP server tools, avoiding direct reading of the binary contents.

Why does my multi-project dotnet build fail with a misleading top-level error?

When a multi-project dotnet build fails with a misleading top-level error, analyzing the .binlog identifies the actual failing target, relevant project inputs, and the underlying compilation or evaluation cause across the cascaded failure.

What is the best way to extract PackageReference and ProjectReference items during build troubleshooting?

The best way to extract PackageReference and ProjectReference items during build troubleshooting is by inspecting the .binlog to gather MSBuild properties, items, and target execution details safely.

Can I analyze a .binlog if the MCP server is unavailable?

Yes, you can analyze a .binlog if the MCP server is unavailable by using a robust fallback workflow that replays the binlog into diagnostic text logs and searches them with targeted patterns.

When do I need a .binlog file for CI troubleshooting?

You need a .binlog file for CI troubleshooting when console output is insufficient, especially when failures cascade across multiple projects and targets in a dotnet build investigation.

Does binlog analysis work for single-project .NET builds?

Yes, binlog analysis works for single and multi-project .NET/MSBuild builds, extracting compilation or evaluation causes and target execution evidence to pinpoint the exact failure.