Skill
Community

dotnet-api

Install
1
Install the plugin
$
npx claudepluginhub novotnyllc/dotnet-artisan --plugin dotnet-artisan

Want just this skill?

Then install: npx claudepluginhub u/[userId]/[slug]

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.

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets
View in Repository
agents/openai.yaml
references/agent-gotchas.md
references/api-docs.md
references/api-security.md
references/api-surface-validation.md
references/api-versioning.md
references/architecture-patterns.md
references/aspire-patterns.md
references/background-services.md
references/cryptography.md
references/data-access-strategy.md
references/efcore-architecture.md
references/efcore-patterns.md
references/file-based-apps.md
references/grpc.md
references/http-client.md
references/hybrid-cache.md
references/identity-setup.md
references/io-pipelines.md
references/library-api-compat.md
Skill Content

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

TopicKeywordsDescriptionCompanion File
Minimal APIsendpoint, route group, filter, TypedResultsMinimal API route groups, filters, TypedResults, OpenAPIreferences/minimal-apis.md
Middlewarepipeline ordering, short-circuit, exceptionPipeline ordering, short-circuit, exception handlingreferences/middleware-patterns.md
EF Core patternsDbContext, migrations, AsNoTrackingDbContext, AsNoTracking, query splitting, migrationsreferences/efcore-patterns.md
EF Core architectureread/write split, aggregate boundaries, N+1Read/write split, aggregate boundaries, N+1references/efcore-architecture.md
Data access strategyEF Core vs Dapper vs ADO.NET decisionEF Core vs Dapper vs ADO.NET decision matrixreferences/data-access-strategy.md
gRPCproto, code-gen, streaming, authProto definition, code-gen, ASP.NET Core host, streamingreferences/grpc.md
Real-timeSignalR, SSE, JSON-RPC, gRPC streamingSignalR hubs, SSE, JSON-RPC 2.0, scalingreferences/realtime-communication.md
ResiliencePolly v8, retry, circuit breaker, timeoutPolly v8 retry, circuit breaker, timeout, rate limiterreferences/resilience.md
HTTP clientIHttpClientFactory, typed/named, DelegatingHandlerIHttpClientFactory, typed/named clients, DelegatingHandlersreferences/http-client.md
API versioningAsp.Versioning, URL/header/query, sunsetAsp.Versioning.Http/Mvc, URL/header/query, sunsetreferences/api-versioning.md
OpenAPIMS.AspNetCore.OpenApi, Swashbuckle, NSwagMS.AspNetCore.OpenApi, Swashbuckle migration, NSwagreferences/openapi.md
API securityIdentity, OAuth/OIDC, JWT, CORS, rate limitingIdentity, OAuth/OIDC, JWT bearer, CORS, rate limitingreferences/api-security.md
OWASPinjection, auth, XSS, deprecated APIsOWASP Top 10 hardening for .NETreferences/security-owasp.md
Secretsuser secrets, env vars, rotationUser secrets, environment variables, rotationreferences/secrets-management.md
CryptographyAES-GCM, RSA, ECDSA, hashing, key derivationAES-GCM, RSA, ECDSA, hashing, PQC key derivationreferences/cryptography.md
Background servicesBackgroundService, IHostedService, lifecycleBackgroundService, IHostedService, lifecyclereferences/background-services.md
AspireAppHost, service discovery, dashboardAppHost, service discovery, components, dashboardreferences/aspire-patterns.md
Semantic KernelAI/LLM plugins, prompts, memory, agentsAI/LLM plugins, prompt templates, memory, agentsreferences/semantic-kernel.md
Architecturevertical slices, layered, pipelines, cachingVertical slices, layered, pipelines, cachingreferences/architecture-patterns.md
MessagingWolverine, Azure Service Bus, RabbitMQ, pub/sub, sagasWolverine, Azure Service Bus, RabbitMQ, pub/sub, sagasreferences/messaging-patterns.md
Service communicationREST vs gRPC vs SignalR decision matrixREST vs gRPC vs SignalR decision matrixreferences/service-communication.md
API surface validationPublicApiAnalyzers, Verify, ApiCompatPublicApiAnalyzers, Verify snapshots, ApiCompatreferences/api-surface-validation.md
Library API compatbinary/source compat, type forwardersBinary/source compat, type forwarders, SemVerreferences/library-api-compat.md
I/O pipelinesPipeReader/PipeWriter, backpressure, KestrelPipeReader/PipeWriter, backpressure, Kestrelreferences/io-pipelines.md
Agent gotchasasync misuse, NuGet errors, DI mistakesCommon agent mistakes in .NET codereferences/agent-gotchas.md
File-based apps.NET 10, directives, csproj migration.NET 10 file-based C# appsreferences/file-based-apps.md
API docsDocFX, OpenAPI-as-docs, versioned docsDocFX, OpenAPI-as-docs, versioned documentationreferences/api-docs.md
HybridCacheHybridCache, L1/L2, stampede, tag evictionHybridCache (.NET 9+), stampede protection, tag-based evictionreferences/hybrid-cache.md
YARPreverse proxy, load balancing, API gateway, BFFYARP reverse proxy, load balancing, health checks, transformsreferences/yarp.md
Output cachingOutputCache, response caching, compressionOutput/response caching, compression, CDN, tag invalidationreferences/output-caching.md
IdentityASP.NET Core Identity, login, MFA, scaffoldingIdentity setup, scaffolding, external providers, MapIdentityApireferences/identity-setup.md
Office documents and PDFExcel, Word, PowerPoint, PDF, Open XML SDK, spreadsheet, docx, xlsx, PDFsharp, MigraDoc, merge PDF, split PDF, watermarkOpen XML SDK, ClosedXML, PDFsharp/MigraDoc for PDF create/read/merge/split/watermarkreferences/office-documents.md

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 -> [skill:dotnet-csharp]
  • UI rendering -> [skill:dotnet-ui]
  • Test authoring -> [skill:dotnet-testing]
  • CI/CD pipelines -> [skill:dotnet-devops]
  • Build tooling -> [skill:dotnet-tooling]
Stats
Stars191
Forks10
Last CommitMar 6, 2026

Similar Skills