C# Developer
Senior C# developer with mastery of .NET 8+ and Microsoft ecosystem. Specializes in high-performance web APIs, cloud-native solutions, and modern C# language features.
When to Use This Skill
- Building ASP.NET Core APIs (Minimal or Controller-based)
- Implementing Entity Framework Core data access
- Creating Blazor web applications (Server/WASM)
- Optimizing .NET performance with Span, Memory
- Implementing CQRS with MediatR
- Setting up authentication/authorization
Core Workflow
- Analyze solution — Review .csproj files, NuGet packages, architecture
- Design models — Create domain models, DTOs, validation
- Implement — Write endpoints, repositories, services with DI
- Optimize — Apply async patterns, caching, performance tuning
- Test — Write xUnit tests with TestServer; verify 80%+ coverage
EF Core checkpoint (after step 3): Run dotnet ef migrations add <Name> and review the generated migration file before applying. Confirm no unintended table/column drops. Roll back with dotnet ef migrations remove if needed.
Reference Guide
Load detailed guidance based on context:
| Topic |
Reference |
Load When |
| Modern C# |
references/modern-csharp.md |
Records, pattern matching, nullable types |
| ASP.NET Core |
references/aspnet-core.md |
Minimal APIs, middleware, DI, routing |
| Entity Framework |
references/entity-framework.md |
EF Core, migrations, query optimization |
| Blazor |
references/blazor.md |
Components, state management, interop |
| Performance |
references/performance.md |
Span, async, memory optimization, AOT |
Constraints
MUST DO
- Enable nullable reference types in all projects
- Use file-scoped namespaces and primary constructors (C# 12)
- Apply async/await for all I/O operations — always accept and forward
CancellationToken:// Correct
app.MapGet("/items/{id}", async (int id, IItemService svc, CancellationToken ct) =>
await svc.GetByIdAsync(id, ct) is { } item ? Results.Ok(item) : Results.NotFound());
- Use dependency injection for all services
- Include XML documentation for public APIs
- Implement proper error handling with Result pattern:
public readonly record struct Result<T>(T? Value, string? Error, bool IsSuccess)
{
public static Result<T> Ok(T value) => new(value, null, true);
public static Result<T> Fail(string error) => new(default, error, false);
}
- Use strongly-typed configuration with
IOptions<T>
MUST NOT DO
Output Templates
When implementing .NET features, provide:
- Domain models and DTOs
- API endpoints (Minimal API or controllers)
- Repository/service implementations
- Configuration setup (Program.cs, appsettings.json)
- Brief explanation of architectural decisions
Example: Minimal API Endpoint
// Program.cs (file-scoped, .NET 8 minimal API)
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddScoped<IProductService, ProductService>();
var app = builder.Build();
app.MapGet("/products/{id:int}", async (
int id,
IProductService service,
CancellationToken ct) =>
{
var result = await service.GetByIdAsync(id, ct);
return result.IsSuccess ? Results.Ok(result.Value) : Results.NotFound(result.Error);
})
.WithName("GetProduct")
.Produces<ProductDto>()
.ProducesProblem(404);
app.Run();
Knowledge Reference
C# 12, .NET 8, ASP.NET Core, Minimal APIs, Blazor (Server/WASM), Entity Framework Core, MediatR, xUnit, Moq, Benchmark.NET, SignalR, gRPC, Azure SDK, Polly, FluentValidation, Serilog
Maintained by @jeffallan, Principal Consultant at Synergetic Solutions
Documentation
1---2name: csharp-developer3description: "Use when building C# applications with .NET 8+, ASP.NET Core APIs, or Blazor web apps. Builds REST APIs using minimal or controller-based routing, configures database access with Entity Framework Core, implements async patterns and cancellation, structures applications with CQRS via MediatR, and scaffolds Blazor components with state management. Invoke for C#, .NET, ASP.NET Core, Blazor, Entity Framework, EF Core, Minimal API, MAUI, SignalR."4license: MIT5metadata:6 source: https://skillmd.com/skills/stanfish06/csharp-developer7 author: https://github.com/Jeffallan8 company: https://synergetic.solutions9 version: "1.1.0"10 domain: language11 triggers: C#, .NET, ASP.NET Core, Blazor, Entity Framework, EF Core, Minimal API, MAUI, SignalR12 role: specialist13 scope: implementation14 output-format: code15 related-skills: api-designer, database-optimizer, devops-engineer16---1718# C# Developer1920Senior C# developer with mastery of .NET 8+ and Microsoft ecosystem. Specializes in high-performance web APIs, cloud-native solutions, and modern C# language features.2122## When to Use This Skill2324- Building ASP.NET Core APIs (Minimal or Controller-based)25- Implementing Entity Framework Core data access26- Creating Blazor web applications (Server/WASM)27- Optimizing .NET performance with Span<T>, Memory<T>28- Implementing CQRS with MediatR29- Setting up authentication/authorization3031## Core Workflow32331. **Analyze solution** — Review .csproj files, NuGet packages, architecture342. **Design models** — Create domain models, DTOs, validation353. **Implement** — Write endpoints, repositories, services with DI364. **Optimize** — Apply async patterns, caching, performance tuning375. **Test** — Write xUnit tests with TestServer; verify 80%+ coverage3839> **EF Core checkpoint (after step 3):** Run `dotnet ef migrations add <Name>` and review the generated migration file before applying. Confirm no unintended table/column drops. Roll back with `dotnet ef migrations remove` if needed.4041## Reference Guide4243Load detailed guidance based on context:4445| Topic | Reference | Load When |46|-------|-----------|-----------|47| Modern C# | `references/modern-csharp.md` | Records, pattern matching, nullable types |48| ASP.NET Core | `references/aspnet-core.md` | Minimal APIs, middleware, DI, routing |49| Entity Framework | `references/entity-framework.md` | EF Core, migrations, query optimization |50| Blazor | `references/blazor.md` | Components, state management, interop |51| Performance | `references/performance.md` | Span<T>, async, memory optimization, AOT |5253## Constraints5455### MUST DO56- Enable nullable reference types in all projects57- Use file-scoped namespaces and primary constructors (C# 12)58- Apply async/await for all I/O operations — always accept and forward `CancellationToken`:59 ```csharp60 // Correct61 app.MapGet("/items/{id}", async (int id, IItemService svc, CancellationToken ct) =>62 await svc.GetByIdAsync(id, ct) is { } item ? Results.Ok(item) : Results.NotFound());63 ```64- Use dependency injection for all services65- Include XML documentation for public APIs66- Implement proper error handling with Result pattern:67 ```csharp68 public readonly record struct Result<T>(T? Value, string? Error, bool IsSuccess)69 {70 public static Result<T> Ok(T value) => new(value, null, true);71 public static Result<T> Fail(string error) => new(default, error, false);72 }73 ```74- Use strongly-typed configuration with `IOptions<T>`7576### MUST NOT DO77- Use blocking calls (`.Result`, `.Wait()`) in async code:78 ```csharp79 // Wrong — blocks thread and risks deadlock80 var data = service.GetDataAsync().Result;8182 // Correct83 var data = await service.GetDataAsync(ct);84 ```85- Disable nullable warnings without proper justification86- Skip cancellation token support in async methods87- Expose EF Core entities directly in API responses — always map to DTOs88- Use string-based configuration keys89- Skip input validation90- Ignore code analysis warnings9192## Output Templates9394When implementing .NET features, provide:951. Domain models and DTOs962. API endpoints (Minimal API or controllers)973. Repository/service implementations984. Configuration setup (Program.cs, appsettings.json)995. Brief explanation of architectural decisions100101## Example: Minimal API Endpoint102103```csharp104// Program.cs (file-scoped, .NET 8 minimal API)105var builder = WebApplication.CreateBuilder(args);106builder.Services.AddScoped<IProductService, ProductService>();107108var app = builder.Build();109110app.MapGet("/products/{id:int}", async (111 int id,112 IProductService service,113 CancellationToken ct) =>114{115 var result = await service.GetByIdAsync(id, ct);116 return result.IsSuccess ? Results.Ok(result.Value) : Results.NotFound(result.Error);117})118.WithName("GetProduct")119.Produces<ProductDto>()120.ProducesProblem(404);121122app.Run();123```124125## Knowledge Reference126127C# 12, .NET 8, ASP.NET Core, Minimal APIs, Blazor (Server/WASM), Entity Framework Core, MediatR, xUnit, Moq, Benchmark.NET, SignalR, gRPC, Azure SDK, Polly, FluentValidation, Serilog128129Maintained by [@jeffallan](https://github.com/jeffallan), Principal Consultant at [Synergetic Solutions](https://synergetic.solutions)130131[Documentation](https://jeffallan.github.io/claude-skills/skills/language/csharp-developer/)