scalar

Configure Scalar API documentation for OpenAPI-driven .NET applications.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/Maj3D10/Training-Platform --skill scalar-maj3d10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scalar
Source: https://github.com/Maj3D10/Training-Platform/tree/main/.agent/skills/scalar
Command: npx skills add https://github.com/Maj3D10/Training-Platform --skill scalar-maj3d10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scalar helps you publish fast, interactive API documentation without the maintenance burden and limitations of older Swagger UI setups, while keeping sensitive “Try It” behavior under control.

Core Features & Use Cases

  • Replace Swagger UI with Scalar: Use Scalar for .NET 10 OpenAPI 3.1 documentation with themes, improved rendering, and an API-docs experience designed for modern developer workflows.
  • Development-first safety: Expose Scalar endpoints in development by default, and require authorization in production to prevent leaking internal API structure.
  • Secure “Try It” behavior: Disable Scalar’s external proxy for sensitive APIs and configure authentication UI strictly from the OpenAPI security schemes.

Quick Start

Use the scalar skill to set up Scalar UI for your OpenAPI documents at /scalar/v1, with Scalar enabled only in development.

Frequently Asked Questions about scalar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I replace Swagger UI with Scalar for ASP.NET Core API documentation?

You can replace Swagger UI with Scalar by mapping Scalar API references using MapScalarApiReference alongside MapOpenApi, configuring custom routes like /scalar/v1, and applying environment guards to expose endpoints securely during development.

How do I secure Scalar Try It calls in production for sensitive APIs?

To secure Scalar Try It calls in production, disable the external proxy by configuring WithProxy(null) and require authorization on the documentation endpoints using .RequireAuthorization to prevent leaking internal API structure.

Can I configure authentication prefill in Scalar for OpenAPI security schemes?

Yes, you can configure authentication prefill in Scalar by defining security schemes within your OpenAPI document, which Scalar then uses to render the authentication UI strictly based on those defined schemes.

Does Scalar support multiple OpenAPI documents in a .NET application?

Scalar supports multiple OpenAPI documents in a .NET application by utilizing MapOpenApi and MapScalarApiReference mappings, allowing you to serve distinct interactive documentation endpoints for different API segments.

What is the best way to prevent unauthorized access to interactive API docs in production?

The best way to prevent unauthorized access to interactive API docs in production is to apply .RequireAuthorization to the Scalar endpoints, ensuring the API documentation routes are protected while remaining available in development environments.

When should I disable the Scalar external proxy for API documentation?

You should disable the Scalar external proxy with WithProxy(null) when exposing sensitive APIs to prevent unauthorized external Try It calls from executing against your production endpoints through the documentation interface.