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.
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