// Guidelines for creating and configuring a new ASP.NET Core Minimal API project. Use when creating a new web API project or when asked to configure an existing one.
| name | aspnet-webapi |
| description | Guidelines for creating and configuring a new ASP.NET Core Minimal API project. Use when creating a new web API project or when asked to configure an existing one. |
| metadata | {"author":"Rainer Stropek"} |
If not asked otherwise, add Open API Specification:
Microsoft.AspNetCore.OpenApiSwashbuckle.AspNetCore.SwaggerUIMicrosoft.Extensions.ApiDescription.Server
Add Open API services to DI (builder.Services.AddOpenApi();)app.UseSwaggerUI(options => options.SwaggerEndpoint("/openapi/v1.json", "v1"));)PropertyGroup in .csproj to generate Open API specification on build (<OpenApiDocumentsDirectory>.</OpenApiDocumentsDirectory>)This will generate an Open API specification file (<project-name>.json) in the project directory on build
Always add proper Open API-related metadata (e.g. .Produces(), .WithDescription(), .WithTags(), etc.) to the endpoints to ensure a good API documentation and client generation experience.
If not asked otherwise, add CORS with allow any origin, header, and method.
If the web API is part of an Aspire application:
builder.AddServiceDefaults())If you are unsure, research in the Aspire documentation at https://aspire.dev/llms.txt.
Retrieve Microsoft Entra access tokens with Azure Identity's DefaultAzureCredential. Use when agents need to get a bearer token in Python or TypeScript, choose a tenant explicitly, understand scopes versus resources, or troubleshoot local developer authentication through Azure CLI and other developer credentials.
Work with Azure Container Apps dynamic sessions through their REST API. Use when agents need to authenticate with Entra ID, create or reuse code interpreter sessions via identifiers, execute Python code inside a session, inspect session metadata, and upload, list, or download files independent of the client programming language.
Guidelines for creating and configuring Angular projects. Use when creating a new Angular project or when asked to configure an existing one.
Aspire skill covering the Aspire CLI, Aspire SDK, and coding guidelines for how we use Aspire. Use when the user asks to create, run, debug, configure, or troubleshoot an Aspire distributed application.