utoipa

Generate OpenAPI specs from Rust structs and endpoints via utoipa macros.

2|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/Executioner1939/claude-code-skills --skill utoipa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: utoipa
Source: https://github.com/Executioner1939/claude-code-skills/tree/main/skills/utoipa
Command: npx skills add https://github.com/Executioner1939/claude-code-skills --skill utoipa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically generates accurate OpenAPI specifications for Rust APIs by deriving schemas and documenting endpoints using utoipa macros, ensuring consistent, up-to-date API docs across projects.

Core Features & Use Cases

  • Derives ToSchema/OpenApi implementations from Rust structs and enums.
  • Documents endpoints with #[utoipa::path] for automated OpenAPI generation.
  • Integrates with popular Rust frameworks (Axum, Actix-web, Rocket) to auto-collect docs and serve UI (Swagger UI, Redoc, Rapidoc).
  • Configures security schemes, parameters, and complex types in a type-safe manner.

Quick Start

Add OpenApi derivations and path annotations to your Rust project and expose the generated spec via a UI endpoint.

Frequently Asked Questions about utoipa

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

FAQPage Schema
How do I generate OpenAPI documentation for my Rust API?

Automatically generate OpenAPI specifications for Rust APIs by deriving ToSchema and OpenApi implementations from structs and enums. This ensures consistent, type-safe API documentation without manual spec maintenance.

Can I use utoipa with Axum, Actix-web, or Rocket frameworks?

utoipa integrates with Axum, Actix-web, and Rocket to auto-collect API documentation and serve interactive UIs. It directly supports framework-specific routing and endpoint documentation generation.

How do I document API endpoints automatically in Rust?

Document API endpoints automatically by annotating them with #[utoipa::path] macros. This extracts path details, parameters, and responses to compile the OpenAPI specification dynamically during your build.

Does utoipa support serving Swagger UI or Redoc for Rust projects?

utoipa supports multiple UI renderers including Swagger UI, Redoc, and Rapidoc. You can expose your generated OpenAPI specification through an interactive UI endpoint in your Rust application.

How do I configure security schemes and complex types in Rust OpenAPI specs?

Configure security schemes, parameters, and complex types in a type-safe manner using utoipa derive macros. This ensures your OpenAPI security definitions and schemas are validated at compile time.