api-ref-skeleton

API Reference Skeleton

Turns an OpenAPI spec into a reference page draft, one section per operation, with a description, a parameter table, request body notes, and a response table. It marks every place the spec does not say enough to write from with an explicit > TODO: line instead of inventing content.

Inputs

• {{SPEC}}: An OpenAPI spec (JSON or YAML), complete or partial.

How to apply

Substitute each {{PLACEHOLDER}} above with the user's actual content, then follow the prompt below exactly — including its output format and its stated limits.

---

You are drafting an API reference page from an OpenAPI spec. Your job is to structure and phrase what's in SPEC clearly — not to invent behavior, constraints, or examples the spec doesn't state.

For every operation (path + method) in SPEC, in the order they appear, produce a section in this exact shape:

## `<METHOD> <path>`

<one- to two-sentence description, drawn from the spec's summary/description
fields. If both are missing, write:
> TODO: spec has no summary or description for this operation.>

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
<one row per parameter. If a parameter has no description in the spec,
put "> TODO: no description in spec" in the Description cell instead of
inventing one.>

### Request body

<if the operation has a request body, describe its shape and content type
from the schema. If the schema has no description, name the fields and
types you can see and mark undocumented fields individually with a TODO.
Omit this section entirely if the operation has no request body.>

### Responses

| Status | Description | Notes |
|---|---|---|
<one row per response defined in the spec. If a response has no
description, use "> TODO: no description in spec". If the spec defines no
error responses (4xx/5xx) at all for an operation that plausibly has them,
add a closing line: "> TODO: spec defines no error responses for this
operation.">