Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

dotnet-aot-compat | DecimalAI

codingby dotnet

dotnet-aot-compat

dotnet/dotnet-aot-compat

Source dotnet/skills ↗License MIT

Make .NET projects compatible with Native AOT and trimming by systematically resolving IL trim/AOT analyzer warnings. USE FOR: making projects AOT-compatible, fixing trimming warnings, resolving IL warnings (IL2026, IL2070, IL2067, IL2072, IL3050), adding DynamicallyAccessedMembers annotations, enabling IsAotCompatible. DO NOT USE FOR: publishing native AOT binaries, optimizing binary size, replacing reflection-heavy libraries with alternatives. INVOKES: no tools — pure knowledge skill.

SkillScore91Maintained

Automatic

Coding pack

Last verified 8/9/2026

What it changes

Passed 18 of 20 test cases with the skill, and 14 of 20 without it.

Without skill68%

With skill91%

Checks it passed that the model alone missed

Recommends escalating to RequiresUnreferencedCode.
Verifies zero IL trim warnings on net8.0 target frameworks.
Recommends using structured code editing tools instead of sed.

and 3 more in the full report

5 fixed15 passed either way2 still failing0 broke

Pass-rate lift: +23 pp
Tokens: +145%
Agent turns: 0%
Response time: -50%

Model gemini-3.6-flashMeasured 8/9/2026v120 of 22 cases passed with skill · 20 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/dotnet-dotnet-aot-compat/SKILL.md https://app.decimal.ai/s/dotnet-dotnet-aot-compat/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add dotnet-dotnet-aot-compat, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/dotnet-dotnet-aot-compat/ and pins it in .decimal/skills.lock

decimalai skills add dotnet-dotnet-aot-compat

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/dotnet-dotnet-aot-compat/SKILL.md https://app.decimal.ai/s/dotnet-dotnet-aot-compat/SKILL.md

Raw file: /s/dotnet-dotnet-aot-compat/SKILL.md ↗ · machine-readable summary at /s/dotnet-dotnet-aot-compat.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 5 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 5

Prompt

We are serializing an Azure.Core.ResponseError instance using JsonSerializer.Serialize(writer, error) and getting IL2026. Should we add [JsonSerializable(typeof(ResponseError))] to our custom JsonSerializerContext?

What was checked, without and with the skill
Checked	Without skill	With skill
Advises against placing third-party external package types into the project's own JsonSerializerContext.	Missed	Passed
Recommends calling IJsonModel methods directly to bypass JsonSerializer.	Missed	Passed

case-12 · gemini-3.6-flash · 8/9/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md256 lines2 files

dotnet-aot-compat

Make .NET projects compatible with Native AOT and trimming by systematically resolving all IL trim/AOT analyzer warnings.

When to Use This Skill

"Make this project AOT-compatible"
"Fix trimming warnings" or "fix IL warnings"
"Resolve IL2070 / IL2067 / IL2072 / IL2026 / IL3050 warnings"
"Add DynamicallyAccessedMembers annotations"
"Enable IsAotCompatible in my .csproj"
"My project has trim analyzer warnings after upgrading to net8.0"
"Annotate reflection code for the trimmer"

When Not to Use This Skill

Do not use this skill when the project exclusively targets .NET Framework (net4x), which does not support the trim/AOT analyzers.

Prerequisites

An existing .NET project targeting net8.0 or later (or multi-targeting with at least one net8.0+ TFM) and the corresponding .NET SDK installed.

Background: What AOT Compatibility Means

Native AOT and the IL trimmer perform static analysis to determine what code is reachable. Reflection can break this analysis because the trimmer can't see what types/members are accessed at runtime. The IsAotCompatible property enables analyzers that flag these issues as build warnings (ILXXXX codes).

Critical Rules

❌ Never suppress warnings incorrectly

NEVER use #pragma warning disable for IL warnings. It hides warnings from the Roslyn analyzer at build time, but the IL linker and AOT compiler still see the issue. The code will fail at trim/publish time.
NEVER use [UnconditionalSuppressMessage]. It tells both the analyzer AND the linker to ignore the warning, meaning the trimmer cannot verify safety. Raising an error at build time is always preferable to hiding the issue and having it silently break at runtime.

💡 Preferred approaches

Prefer [DynamicallyAccessedMembers] annotations to flow type information through the call chain.
Prefer refactoring to eliminate patterns that break annotation flow (e.g., boxing Type through object[]).
Use [RequiresUnreferencedCode] / [RequiresDynamicCode] / [RequiresAssemblyFiles] to mark methods as fundamentally incompatible with trimming, propagating the requirement to callers. This surfaces the issue clearly rather than hiding it — callers must explicitly acknowledge the incompatibility.

Annotation flow is key

Track record

Benchmark

18 / 20

test cases passed, vs 14 / 20 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

dotnet / skills

plugins/dotnet-upgrade/skills/dotnet-aot-compat/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1Bundled 1 file

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

dotnet-aot-compat

When to Use This Skill

When Not to Use This Skill

Prerequisites

Background: What AOT Compatibility Means

Critical Rules

❌ Never suppress warnings incorrectly

💡 Preferred approaches

Annotation flow is key

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills