clr-activation-debugging

Analyze CLR activation logs to diagnose .NET Framework runtime loading failures.

5.1k|377|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/dotnet/skills --skill clr-activation-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clr-activation-debugging
Source: https://github.com/dotnet/skills/tree/main/plugins/dotnet-diag/skills/clr-activation-debugging
Command: npx skills add https://github.com/dotnet/skills --skill clr-activation-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues where the .NET Framework Common Language Runtime (CLR) fails to load or activates with the wrong version, often occurring with older .NET Framework applications.

Core Features & Use Cases

  • Analyze CLR Activation Logs: Parses detailed logs generated by the .NET shim (mscoree.dll) to understand runtime selection decisions.
  • Identify Root Causes: Pinpoints why the shim might pick the wrong CLR version, fail to load any CLR, or trigger unexpected Feature-on-Demand dialogs.
  • Use Case: A legacy COM component fails to instantiate, and the error message suggests a CLR loading problem. This Skill can analyze the CLR activation logs to determine if the shim is incorrectly selecting an older CLR version when a newer one is available or expected.

Quick Start

Analyze the provided CLR activation log files to diagnose the .NET runtime activation failure.

Frequently Asked Questions about clr-activation-debugging

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

FAQPage Schema
Why does the .NET Framework shim load the wrong CLR version during activation?

The .NET Framework shim might load the wrong CLR version due to conflicting runtime configuration policies or legacy COM component requirements. Analyzing CLR activation logs reveals the exact runtime selection decisions made by mscoree.dll to pinpoint the mismatch.

How do I debug .NET Framework CLR activation failures?

To debug .NET Framework CLR activation failures, you need to generate and analyze CLR activation logs. This Skill parses those CLRLoad logs produced by mscoree.dll to identify why the runtime failed to load or selected an incorrect version.

What causes unexpected Feature-on-Demand dialogs when loading .NET Framework applications?

Unexpected Feature-on-Demand dialogs during .NET Framework loading occur when the CLR activation shim cannot find the requested runtime version. Examining the CLR activation logs helps determine if a required .NET Framework version is missing or incorrectly referenced.

Can I use CLR activation logs to troubleshoot legacy COM component runtime loading issues?

Yes, you can use CLR activation logs to troubleshoot legacy COM component runtime loading issues. The logs trace the mscoree.dll shim's runtime selection process, helping you identify if an older CLR version is being incorrectly activated instead of the expected one.

What do I need to diagnose .NET runtime activation issues?

You need CLR activation logs generated by the .NET Framework shim to diagnose .NET runtime activation issues. These logs serve as the required input for analyzing runtime selection failures, incorrect version loading, and Feature-on-Demand triggers.

CLR activation not working, what are the common limitations when analyzing mscoree.dll logs?

A limitation when analyzing mscoree.dll logs is that the diagnostic process strictly requires CLR activation logs as input. Without these pre-generated CLRLoad logs, the root cause of the .NET Framework runtime activation failure cannot be determined.