Skip to content

amakaflow/fastapi-openapi-hygiene

v0.1.0

Offline OpenAPI lint for FastAPI: optional-anyof piles, missing discriminators, bare untyped object responses.

GitHub

fastapi-openapi-hygiene

Offline OpenAPI lint Agent Plugin for FastAPI contracts (ADR-008).

Tools

ToolPurpose
lint_openapi_fileLint OpenAPI JSON on disk
lint_openapi_jsonLint in-memory OpenAPI object/string

Findings

OpenApiHygieneFinding = { pointer, rule, severity, message }

Fixtures

  • fixtures/good.json — clean
  • fixtures/bad-optional-pile.json — optional-anyof pile, missing discriminator, bare object response

Layout

  • plugin.json / mcp.json / server.mjs
  • skills/fastapi-openapi-hygiene/SKILL.md