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