skills.rest
diazvaldiviav
diazvaldiviavCOMMUNITY
Explore all skills by this author →
GitHub

.NET Known Issues

Catalog .NET, Avalonia, and SQLite pitfalls with symptoms, causes, and correct patterns.

Updated Mar 4, 2026
Search Tags:#best practices#debugging#async#c##.net#threading
One-click install
npx skills add https://github.com/diazvaldiviav/Nexus-agent --skill net-known-issues
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: .NET Known Issues
Source: https://github.com/diazvaldiviav/Nexus-agent/tree/main/.claude/skills/dotnet-known-issues
Command: npx skills add https://github.com/diazvaldiviav/Nexus-agent --skill net-known-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers avoid critical and common pitfalls in .NET development, such as deadlocks, socket exhaustion, and UI thread issues, leading to more robust and stable applications.

Core Features & Use Cases

  • Identifies Critical Pitfalls: Details issues like sync-over-async, HttpClient misuse, SQLite threading problems, Avalonia UI thread exceptions, and async void dangers.
  • Provides Correct Patterns: Offers clear, actionable code examples demonstrating the right way to handle asynchronous operations, resource management, and UI updates.
  • Use Case: A developer is implementing a new feature involving asynchronous database access and is unsure about the best practices. They consult this Skill to ensure they don't introduce deadlocks or thread-safety issues.

Quick Start

Consult the checklist for a quick summary of common .NET pitfalls and their solutions.

Frequently Asked Questions about .NET Known Issues

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

FAQPage Schema
Why does my .NET async method deadlock when called synchronously?▼

Sync-over-async deadlocks occur when blocking on async tasks, causing thread starvation. This Skill details the root cause and provides correct async patterns to avoid deadlocks in .NET applications.

How do I fix HttpClient socket exhaustion in C#?▼

HttpClient socket exhaustion happens from creating new instances per request. This Skill explains the root cause and demonstrates the correct pattern using shared HttpClient instances to prevent socket exhaustion.

What are the dangers of using async void in C#?▼

Async void exceptions crash the application because they cannot be caught by the calling method. This Skill catalogs the severity of async void pitfalls and shows correct patterns for proper exception handling.

How do I handle SQLite threading and connection issues in .NET?▼

SQLite threading problems arise from sharing connections across threads. This Skill provides correct patterns for SQLite connection handling and thread safety to ensure robust database access.

How do I safely update the UI thread in Avalonia?▼

Avalonia UI thread exceptions occur when updating controls from background threads. This Skill details correct patterns for UI thread dispatching and CancellationToken propagation to ensure stable applications.

Related Skills

Explore More Software Engineering Skills→
jim60105jim60105
21

csharp-project-init

Initialize C# ASP.NET Core Web API projects with Entity Framework Core and configuration files.

Community
Intermediate
tomguntomgun

fixing-bugs

Reproduce bugs with regression tests and apply minimal root-cause fixes.

Community
Intermediate
AGIBuildAGIBuild
10

dotnet-csharp-async-patterns

Guide async/await, Task, ValueTask, and CancellationToken usage in C# code.

Community
Intermediate
ChiejiChieji

azure-messaging

Diagnose and resolve Azure Messaging SDK issues for Event Hubs and Service Bus.

Community
Intermediate