OpenAPI and Request Collection Builder

About this skill

A human-readable API doc tells a person how the API works. A spec and a collection let a machine — and a developer integrating in a hurry — actually call it: generate clients, mock servers, contract tests, and one-click test requests. Most APIs never get either, because writing OpenAPI by hand is tedious and keeping example requests in sync is worse. OpenAPI and Request Collection Builder writes both from the code you already have. Give it your route definitions, handlers, and models, plus how the API authenticates, and it produces a valid OpenAPI 3.1 document — every path and operation with parameters, request bodies, and the real error responses; schemas derived from your models and defined once, then referenced everywhere; security schemes matching your actual auth; and realistic examples — alongside a companion request collection grouped by resource, with the base URL and token as environment variables and auth wired in, so it runs the moment a real token is dropped in. It derives values from your code rather than inventing them: anything the code doesn't reveal becomes a clearly marked TODO for you to confirm, not a guessed value presented as real. The download includes three reference files: an OpenAPI structure guide, a collection structure guide, and a worked sample that turns an Express API into a spec and a collection. It writes the artifacts from your code — it doesn't call your API or verify the endpoints behave as described, so validate the spec and run the collection against a real environment to confirm. Works with Claude Code, Cursor, Codex CLI, Gemini CLI, and any SKILL.md agent.