openai-schemalisted

This skill queries the OpenAI OpenAPI spec (~26k lines, 148 endpoints, 477 schemas) without loading the full file into context. Use when implementing or modifying Anthropic-to-OpenAI translation logic, checking OpenAI API field names/types, verifying schema shapes, or comparing request/response structures. Triggers on questions about OpenAI API structure, field types, endpoint parameters, or schema definitions.
whit3rabbit/anyllm-proxy · ★ 2 · AI & Automation · score 68

Install: claude install-skill whit3rabbit/anyllm-proxy

# OpenAI API Schema Query Query the OpenAI OpenAPI spec (v2.3.0, 148 endpoints, 477 schemas) for specific endpoints, schemas, and fields. The full spec is ~1.4MB/26k lines; this skill provides targeted lookups without loading it all into context. ## Setup The query script requires PyYAML via the project venv: ```bash scripts/.venv/bin/python3 .Codex/skills/openai-schema/scripts/query-openai-schema.py <command> ``` If the venv does not exist: ```bash python3 -m venv scripts/.venv && scripts/.venv/bin/pip install pyyaml ``` The spec is auto-downloaded and cached to `scripts/.cache/openapi.yaml` on first run. ## Commands ### List available API tag groups ```bash scripts/.venv/bin/python3 .Codex/skills/openai-schema/scripts/query-openai-schema.py tags ``` ### List endpoints (optionally filter by tag or path) ```bash scripts/.venv/bin/python3 .Codex/skills/openai-schema/scripts/query-openai-schema.py endpoints --filter chat ``` ### Show endpoint detail by operationId or path ```bash scripts/.venv/bin/python3 .Codex/skills/openai-schema/scripts/query-openai-schema.py endpoint createChatCompletion ``` Returns: method, path, tags, summary, parameters, request body ref, response refs. ### Show schema detail with configurable depth ```bash scripts/.venv/bin/python3 .Codex/skills/openai-schema/scripts/query-openai-schema.py schema CreateChatCompletionRequest --depth 2 ``` - `--depth 0`: schema composition only (allOf/oneOf refs) - `--depth 1` (default): properties with types