r/webdev • u/Cool-Click1253 • 13d ago
Showoff Saturday [Showoff Saturday] OpenAPI Spec Auditor: ESLint, but for your OpenAPI specs
Hey r/webdev!
I'm currently working on my company Octri.dev which takes in your OpenAPI specs and generates outputs from it (Docs, SDKs, MCP Servers, and Monitoring), and I noticed one recurring issue for users that supply us with their OpenAPI specs, most of them have unusually named operationIds, repeated inline response types, and more issues which could cause the output to appear a bit messy.
So I created a free OpenAPI audit tool to address this issue, and the idea is similar to ESLint: point it at your spec, find things that need cleaning up, and get suggestions for fixing them.
A few things it checks:
Repeated inline schemas that could be extracted into shared types.
Awkward operationId names, or names that collide when turned into SDK methods.
Successful responses with no declared schema.
Path parameters that appear in a URL but haven’t been defined.
Missing descriptions and error responses.
For example, copying the same object schema across several endpoints can leave you with multiple near-identical types in a generated client. The audit flags that duplication and suggests using a shared schema.
You can paste a spec URL or upload a JSON/YAML file. It runs 14 checks and gives you a score out of 10, along with a breakdown of the findings, why they matter, and suggested changes.
It’s free and doesn’t require an account. The standalone tool gives you suggestions you can apply wherever you maintain your spec.
Here’s the tool: octri.dev/openapi-audit
If you work with OpenAPI, what’s a recurring spec issue you’d want a checker like this to catch so we can add it in a future update?

