Agent skill

Dotnet API

by novotnyllc in novotnyllc/dotnet-artisan

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…

MITAuto-check passedBackend & APIs

Install Dotnet API

skills CLI
$ npx skills add novotnyllc/dotnet-artisan --skill dotnet-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install novotnyllc/dotnet-artisan dotnet-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/novotnyllc/dotnet-artisan.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/dotnet-artisan/skills/dotnet-api .claude/skills/dotnet-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dotnet-api
GitHub stars
233
Token cost
~1.6k tokens
SKILL.md length
589 words
Files
34 (incl. references)
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

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…

  • UI rendering patterns
  • SKILL.md covers Overview, Routing Table, Scope and Out of scope
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • CI/CD pipeline authoring

What it does

Dotnet API is an agent skill from novotnyllc/dotnet-artisan. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 35 other files, including reference files (for example `agents/openai.yaml`, `references/agent-gotchas.md` and `references/api-docs.md`).

It sits in Backend & APIs, covering gRPC and Protobuf, Software architecture and OpenAPI specifications. It works with .NET, ASP.NET Core, gRPC and OpenAPI. The repository describes itself as: Comprehensive .NET development skills for modern C and .NET. The licence is MIT.

When your agent uses it

  • UI rendering patterns
  • CI/CD pipeline authoring

Example prompts

  • “Use the dotnet-api skill to build ASP.NET Core APIs, EF Core data access, gRPC, SignalR, and backend services with middleware, security (OAuth, JWT…”
  • “/dotnet-api”

What it can do on your machine

Read from SKILL.md and the folder at commit 3db3ae6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dotnet API loads about 1.6k tokens when it runs, and up to ~127k if it reads all its reference files. Until then it costs about 104 tokens; SKILL.md has 589 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~104
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~127k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from novotnyllc/dotnet-artisan at commit 3db3ae6, republished under its MIT licence (© novotnyllc). 589 words, ~1,649 tokens.

Download SKILL.mdSave it as .claude/skills/dotnet-api/SKILL.md (or your agent's skills folder). This skill also uses 33 other files; get the full folder from GitHub.
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

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
Show full SKILL.md (59 more words)Show less

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

© novotnyllc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 33 other files (references) in plugins/dotnet-artisan/skills/dotnet-api of novotnyllc/dotnet-artisan.

  • SKILL.md
  • 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
  • … and 15 more

Open the folder on GitHubat commit 3db3ae6

Compare with similar skills

Dotnet API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dotnet API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dotnet API this skillnovotnyllc/dotnet-artisan233—~1.6kAutomated safety check: PassMIT
Dotnet Webapidotnet/skills5.6k2 repos~5.5kAutomated safety check: PassMIT
Hunt APIEncod3d-Sec/TORCH329—~1.9kAutomated safety check: PassMIT
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
Aspnet Corefanslead/ReverseProxy.Store1632 repos~1.4kAutomated safety check: PassApache-2.0
Tsp Csharpquerylenshq/ef-querylens225—~1.3kAutomated safety check: PassMIT

Similar skills

  • Dotnet Webapi

    dotnet/skills

    Official

    Guides creation and modification of ASP.NET Core Web API endpoints with correct HTTP semantics, OpenAPI metadata, and error handling.

    5.6k GitHub starsUsed in 2 repos~5.5k tokens
    Backend & APIsAuto-check passed
  • Hunt API

    Encod3d-Sec/TORCH

    API attack hunting (REST / GraphQL / gRPC) - BOLA/IDOR, BFLA, mass assignment, excessive data exposure, auth/JWT, introspection + batching, rate-limit abuse.

    329 GitHub stars~1.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Aspnet Core

    fanslead/ReverseProxy.Store

    Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development.

    163 GitHub starsUsed in 2 repos~1.4k tokens
    Backend & APIsAuto-check passed
  • Tsp Csharp

    querylenshq/ef-querylens

    Comprehensive C and .NET development skill for TSP projects.

    225 GitHub stars~1.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Verify Authendpoints

    madeyoga/AuthEndpoints

    Drive the AuthEndpoints HTTP API via the in-repo test host (cookie sessions, Identity bearer, Simple JWT, CSRF, ReAuth).

    121 GitHub stars~2.6k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed

More from novotnyllc/dotnet-artisan

All 9 skills in this repo
  • Dotnet Debugging

    novotnyllc/dotnet-artisan

    Debugs Windows and Linux/macOS applications (native, .NET/CLR, mixed-mode) with WinDbg MCP (crash dumps, !analyze, !syncblk, !dlk, !runaway, !dumpheap, !gcroot, BSOD), dotnet-dump, lldb with SOS…

    233 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Dotnet Tooling

    novotnyllc/dotnet-artisan

    Manages .NET SDK installation (dotnet-install, workloads), project setup (.slnx, Directory.Build.props, CPM), MSBuild authoring, build optimization, performance (Span, ArrayPool, stackalloc)…

    233 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dotnet Csharp

    novotnyllc/dotnet-artisan

    Baseline C skill loaded for every .NET code path. An agent skill from novotnyllc/dotnet-artisan.

    233 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Using Dotnet

    novotnyllc/dotnet-artisan

    Detects .NET intent for any C, ASP.NET Core, EF Core, Blazor, MAUI, Uno Platform, WPF, WinUI, SignalR, gRPC, xUnit, NuGet, or MSBuild request from prompt keywords and repository signals (.sln…

    233 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Dotnet Devops

    novotnyllc/dotnet-artisan

    Configures .NET CI/CD pipelines (GitHub Actions with setup-dotnet, NuGet cache, reusable workflows; Azure DevOps with DotNetCoreCLI, templates, multi-stage), containerization (multi-stage…

    233 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Dotnet Testing

    novotnyllc/dotnet-artisan

    Defines .NET test strategy and implementation patterns across xUnit v3 (Facts, Theories, fixtures, IAsyncLifetime), integration testing (WebApplicationFactory, Testcontainers), Aspire testing…

    233 GitHub stars~972 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Dotnet API

What does Dotnet API do?

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…. Dotnet API is an agent skill from novotnyllc/dotnet-artisan.NET Aspire, Semantic Kernel, HybridCache, YARP reverse proxy, output caching, Office documents (Excel, Word, PowerPoint), PDF, and architecture patterns.

When should I use Dotnet API?

Dotnet API fits situations like: UI rendering patterns; CI/CD pipeline authoring.

How do I install Dotnet API in Claude Code?

Run `npx skills add novotnyllc/dotnet-artisan --skill dotnet-api -a claude-code`. Or copy the skill folder (plugins/dotnet-artisan/skills/dotnet-api in novotnyllc/dotnet-artisan) into .claude/skills/dotnet-api in your project. Claude Code loads it when a task matches its description.

How do I install Dotnet API in Codex?

Run `npx skills add novotnyllc/dotnet-artisan --skill dotnet-api -a codex`. Or copy the skill folder (plugins/dotnet-artisan/skills/dotnet-api in novotnyllc/dotnet-artisan) into .agents/skills/dotnet-api in your project. Codex loads it when a task matches its description.

Can I use Dotnet API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add novotnyllc/dotnet-artisan --skill dotnet-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dotnet-api, .gemini/skills/dotnet-api, .github/skills/dotnet-api and .opencode/skills/dotnet-api in your project.

What does Dotnet API need to run?

SKILL.md names no scripts, command-line tools or credentials: Dotnet API is instructions for the agent only.

Does Dotnet API access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dotnet API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dotnet API use?

Dotnet API is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dotnet API use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 125k tokens, read only when the agent opens those files.

What are the alternatives to Dotnet API?

Skills that share tags, products or a category with Dotnet API: Dotnet Webapi (dotnet/skills, 5.6k stars), Hunt API (Encod3d-Sec/TORCH, 329 stars), Use Yaak (mountain-loop/yaak, 19k stars) and Aspnet Core (fanslead/ReverseProxy.Store, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dotnet API?

novotnyllc (a GitHub organization) maintains it in novotnyllc/dotnet-artisan, which has 233 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 18, 2026.

Source: novotnyllc/dotnet-artisan on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.