OpenAPI / REST schema

SkillDev tools

Apply when changing the REST API surface — actix handlers, utoipa annotations, or request/response types under server/.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the OpenAPI / REST schema skill

What this skill tells your AI

The instructions your AI receives, as published by varfish-org/mehari in .claude/skills/openapi/SKILL.md and read by ahel’s review.

Server: actix-web + utoipa, behind the server feature. ApiDoc in mehari/src/server/run/mod.rs; Swagger UI via utoipa-swagger-ui.
Spec is checked in at openapi.schema.yaml (repo root). A CI Schema job regenerates it and diffs against the committed file (stripping the version: line), so it must stay in sync.

After ANY API-surface change (routes, handlers, #[utoipa::path], schema structs), regenerate and commit the schema in the same PR, or CI fails:

cargo run -p mehari --bin mehari -- server schema --output-file openapi.schema.yaml

Review the diff (the version: line doesn't matter — CI strips it).

Advanced