Axum (Rust) — Production Web APIs

What it does

This skill provides a concise, opinionated guide to building production-grade HTTP APIs in Rust using the Axum framework. It covers router composition, typed extractors (Path/Query/Json/State), shared application state patterns, structured error types that implement IntoResponse, Tower/Tower-HTTP middleware (tracing, timeouts, CORS), graceful shutdown, and router testing using tower::ServiceExt. The SKILL.md includes runnable code snippets and decision guidance (Axum vs Actix vs Warp).

When to use it

Use this skill when you are developing Rust microservices or APIs that require predictable middleware composition, strong typing at the request boundary, observability (tracing/timeouts), and clean error mapping for HTTP responses. Ideal for teams shipping typed handlers, integrating DB pools or clients into State, and wanting testable routers without opening sockets.

What's included

• Scripts: none embedded, but plentiful code examples in the SKILL.md
• References: links to Axum, Tower-HTTP and Tracing docs
• Instructions: quick-start steps (add dependencies, build Router, define AppState, add tracing+timeouts, test with ServiceExt) and production pattern recipes (state via Arc, structured errors, middleware layers, graceful shutdown).

Compatible agents

Best read/used by code-capable agents (Claude Code, Codex, Cursor, Gemini CLI) that can surface code snippets and run tests locally.