| name | api-docs-scalar |
| description | API documentation provider skill for Scalar. Load only when backend config selects Scalar and the task touches API documentation wiring.
|
| requires | ["dotnet-api"] |
| produces | ["scalar-api-docs"] |
API Docs — Scalar
🚨 NON-NEGOTIABLE RULES — ZERO TOLERANCE
- ONLY use this skill when
Docs/Application/Architecture/backend-config.md selects Scalar
- ALWAYS expose docs only in Development unless a future skill says otherwise
- NEVER wire Swagger UI together with Scalar in the same host
Package and wiring
<PackageReference Include="Scalar.AspNetCore" Version="2.+" />
builder.Services.AddOpenApi();
if (app.Environment.IsDevelopment())
{
app.MapOpenApi();
app.MapScalarApiReference(options =>
{
options.WithTitle("YourProject API");
});
}
- OpenAPI JSON:
/openapi/v1.json
- Scalar UI:
/scalar/v1