What problem does it solve? Writing OpenAPI specifications for third-party APIs by hand is slow and error-prone, especially when providers publish only prose documentation or outdated spec versions. This Skill automates the creation of validated OpenAPI 3.2.0 documents for external APIs you integrate with. ## Core Features & Use Cases - Provider-aware generation: Built-in profiles for 15+ providers (OpenAI, Anthropic, Google, Microsoft Graph, Stripe, GitHub, Slack, AWS, Twilio, and more) with correct auth schemes, base URLs, and pagination patterns. - OAS 3.2.0 features: Structured tags, reusable mediaTypes, webhooks, and native streaming support via text/event-stream and application/x-ndjson with itemSchema. - Official spec upgrading: Fetches a provider's published OpenAPI spec when available and upgrades it to 3.2.0 instead of writing from scratch. - Validation and multi-file output: Checks specs against 11 mandatory rules and 10 best practices, and splits large specs (50+ endpoints) into modular path and component files. - Use Case: You are building an SDK or API gateway integration for the Slack Web API. Ask the Skill to generate the spec, and it produces a validated specs/slack/openapi.yaml with bot-token auth, cursor pagination, and standard error responses. ## Quick Start Ask the assistant to generate an OpenAPI 3.2.0 spec for the provider you are integrating with, for example by saying create an OAS spec for the Stripe API.
