Good descriptions of endpoints, parameters and fields in OpenAPI specs are useful, but slow to write.
When using OpenAPI specs while building AI assistants, we found LLM tool use improves a lot if the spec is well described (also recommended by Anthropic [1]).
We forked a previous Show HN repo [2] to help write descriptions. That project builds the API spec by watching the network requests. We’ve added LLM calls to write the descriptions.
We hope you find it useful!
[1] https://docs.anthropic.com/en/docs/tool-use#best-practices-f...
[2] https://news.ycombinator.com/item?id=38012032