Cool idea! The docs are a little out of sync with what I'm seeing in the responses. I created an OpenAPI spec and generated some SDKs! Here's the python one: https://github.com/stainless-commons/rollin-python
The Stainless docs platform does some chunking and indexing by default and also gives per endpoint code snippets for different languages. This is more for companies who want to improve the agent experience for devs than for individuals working directly from an open api spec.
Super simple OSS tool to run with skills or at the CLI. npx @cjavdev/agent-lint https://docs.example.com
Looking forward to being inspired by your checks!