dotnet-api

name	dotnet-api
description	Builds ASP.NET Core APIs, EF Core data access, gRPC, SignalR, and backend services with middleware, security (OAuth, JWT, OWASP), resilience, messaging, OpenAPI, .NET Aspire, Semantic Kernel, HybridCache, YARP reverse proxy, output caching, Office documents (Excel, Word, PowerPoint), PDF, and architecture patterns. Spans 32 topic areas. Do not use for UI rendering patterns or CI/CD pipeline authoring.
license	MIT
user-invocable	false

dotnet-api

Overview

ASP.NET Core APIs, data access, backend services, security, and cloud-native patterns. This consolidated skill spans 32 topic areas. Load the appropriate companion file from references/ based on the routing table below.

Baseline dependency: references/minimal-apis.md defines the core ASP.NET Core Minimal API patterns (route groups, endpoint filters, TypedResults, parameter binding) that apply to most API development tasks. Load it by default when building HTTP endpoints.

Most-shared companion: references/architecture-patterns.md covers vertical slices, request pipelines, error handling, caching, and idempotency patterns used across nearly all ASP.NET Core projects.

Routing Table

Topic	Keywords	Description	Companion File
Minimal APIs	endpoint, route group, filter, TypedResults	Minimal API route groups, filters, TypedResults, OpenAPI	references/minimal-apis.md
Middleware	pipeline ordering, short-circuit, exception	Pipeline ordering, short-circuit, exception handling	references/middleware-patterns.md
EF Core patterns	DbContext, migrations, AsNoTracking	DbContext, AsNoTracking, query splitting, migrations	references/efcore-patterns.md
EF Core architecture	read/write split, aggregate boundaries, N+1	Read/write split, aggregate boundaries, N+1	references/efcore-architecture.md
Data access strategy	EF Core vs Dapper vs ADO.NET decision	EF Core vs Dapper vs ADO.NET decision matrix	references/data-access-strategy.md
gRPC	proto, code-gen, streaming, auth	Proto definition, code-gen, ASP.NET Core host, streaming	references/grpc.md
Real-time	SignalR, SSE, JSON-RPC, gRPC streaming	SignalR hubs, SSE, JSON-RPC 2.0, scaling	references/realtime-communication.md
Resilience	Polly v8, retry, circuit breaker, timeout	Polly v8 retry, circuit breaker, timeout, rate limiter	references/resilience.md
HTTP client	IHttpClientFactory, typed/named, DelegatingHandler	IHttpClientFactory, typed/named clients, DelegatingHandlers	references/http-client.md
API versioning	Asp.Versioning, URL/header/query, sunset	Asp.Versioning.Http/Mvc, URL/header/query, sunset	references/api-versioning.md
OpenAPI	MS.AspNetCore.OpenApi, Swashbuckle, NSwag	MS.AspNetCore.OpenApi, Swashbuckle migration, NSwag	references/openapi.md
API security	Identity, OAuth/OIDC, JWT, CORS, rate limiting	Identity, OAuth/OIDC, JWT bearer, CORS, rate limiting	references/api-security.md
OWASP	injection, auth, XSS, deprecated APIs	OWASP Top 10 hardening for .NET	references/security-owasp.md
Secrets	user secrets, env vars, rotation	User secrets, environment variables, rotation	references/secrets-management.md
Cryptography

Scope

• ASP.NET Core web APIs (minimal and controller-based)
• Data access (EF Core, Dapper, ADO.NET)
• Service communication (gRPC, SignalR, SSE, messaging)
• Security (auth, OWASP, secrets, crypto)
• Cloud-native (Aspire, resilience, background services)
• AI integration (Semantic Kernel)
• Architecture patterns and API surface validation

Out of scope

• C# language features -> dotnet-csharp
• UI rendering -> dotnet-ui
• Test authoring -> dotnet-testing
• CI/CD pipelines -> dotnet-devops
• Build tooling -> dotnet-tooling