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.