PlugWiki

ASP.NET Minimal API OpenAPI Skill: Typed Endpoints with Docs

Guides your agent to write ASP.NET Minimal API endpoints with strong types and full OpenAPI documentation. Listed in github/awesome-copilot.

Installs
9.2K
on skills.sh
Stars
40.7K
on GitHub
Updated
Oct 2026
last repo commit

aspnet-minimal-api-openapi makes your agent follow a short rulebook when it writes Minimal API endpoints. The rules group endpoints with MapGroup, use explicit request and response types, return TypedResults, and document operations with the built-in OpenAPI support from .NET 9.

It bundles no scripts and is a one-page checklist, not a generator. It edits the code you ask it to change.

Good for

  • C# developers building Minimal APIs on .NET 9 or newer
  • Teams that want every endpoint documented in OpenAPI
  • Developers cleaning up untyped endpoints

Install aspnet-minimal-api-openapi

Claude Code

  1. 1

    Copy this prompt.

    Install the aspnet-minimal-api-openapi skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill aspnet-minimal-api-openapi

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The awesome-copilot README is written for GitHub Copilot. It does not name Claude Code, so these are the standard skill-folder routes.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Create ASP.NET Minimal API endpoints with proper OpenAPI documentation

Sections in SKILL.md

  1. API Organization
  2. Request and Response Types
  3. Type Handling
  4. OpenAPI Documentation

Key facts

Author
Plugin author listed as Awesome Copilot Community
License
MIT (LICENSE file of the awesome-copilot repo)
Installs on skills.sh
9,186 (Nov 2, 2026)
GitHub stars
40,666 for the whole awesome-copilot repo (Nov 2, 2026)
Last repo commit
Oct 30, 2026
Files in the folder
1 file: SKILL.md
Part of
The csharp-dotnet-development plugin (9 skills and 1 agent listed in plugin.json)

What it includes

  • Groups endpoints with MapGroup, uses endpoint filters and feature folders

    Four rules, including separate endpoint classes for larger APIs.

    Write · API organization

  • Uses explicit DTOs, records, validation attributes and ProblemDetails

    Six rules, such as [Required] attributes and standard error responses.

    Write · Request and response types

  • Uses typed route parameters, Results<T1, T2> and TypedResults

    Four rules, including C# 10+ features such as init-only properties.

    Write · Type handling

  • Adds summaries, WithName operation IDs, [Description()] and transformers

    Seven rules, built on the OpenAPI document support added in .NET 9.

    Write · OpenAPI documentation

From the official docs

Permissions

Low risk

The skill edits your API code, which can change what clients see. The plugin route also adds an agent that can edit files and run commands, so use the skill-only route if you do not want that.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • The Copilot plugin adds agents that can edit files

    The csharp-dotnet-development plugin lists the expert-dotnet-software-engineer agent. Its tools include editFiles, runCommands, runTasks and runTests. Install the skill alone if you do not want that. github.com

  • It edits your API code

    The rules reshape endpoints, types and return values, which can change your API contract. Review the diff and run your tests. github.com

  • Community content, not reviewed by GitHub for you

    The awesome-copilot README says the customizations are sourced from third-party developers and asks you to inspect them before installing. Read the SKILL.md first. github.com

Technical details
Scopes

  • Edits C# endpoint code you point it at

  • The Copilot plugin route adds an agent with edit and command tools

Questions

What does aspnet-minimal-api-openapi do?

It gives your agent rules for writing ASP.NET Minimal API endpoints with clear types and OpenAPI docs. It covers 21 rules in four groups.

How do I install it?

Use the install box above. In GitHub Copilot CLI it can also come with the csharp-dotnet-development plugin, which lists nine skills and one agent.

Which .NET version does it need?

The OpenAPI rule says to use the built-in document support added in .NET 9. The type rules mention C# 10+ features.

Does it generate a project?

No. It is a checklist for writing and cleaning up endpoints, not a project generator.

Is it safe?

It bundles no scripts. It changes C# code you point it at, so use version control and review the diff. The csharp-dotnet-development plugin adds an agent that can edit files and run commands.

Does it work in Claude Code or the Claude app?

The file is a standard SKILL.md, and the install box shows how to place it in Claude Code or upload it to Claude. The awesome-copilot README targets GitHub Copilot, and nothing in the repo says this skill was tested in Claude.

Information

updated Nov 2, 2026

Repository
github/awesome-copilot
Folder
skills/aspnet-minimal-api-openapi

github/awesome-copilotskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4
  1. github/awesome-copilot README · github.com
  2. csharp-dotnet-development plugin.json · github.com
  3. aspnet-minimal-api-openapi SKILL.md · github.com
  4. expert-dotnet-software-engineer agent · github.com

Updated Nov 2, 2026.