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.
E.g. https://docs.sendblue.com/api/typescript/resources/messages/...
So asking users to put yet another file in their repo of dubious value is going to be a major hurdle
Fwiw, my agentic framework turns OpenAPI into a toolset automatically for me, so you are def making something I already have