openapi-directory-first

What problem does it solve?

This Skill prevents reliance on stale training data by directing you to authoritative, machine-readable OpenAPI specifications so you can avoid incorrect endpoint usage, parameter types, and auth assumptions.

Core Features & Use Cases

• Authoritative Specs: Locate canonical OpenAPI 2.0 and 3.x files in the APIs-guru openapi-directory for accurate endpoint signatures, parameters, request/response schemas, and security schemes.
• Accurate Integration & Debugging: Confirm parameter types, update endpoint paths, and validate requests/responses against schema definitions to resolve integration issues.
• Client Generation & Reference: Use the specs to generate client code or types and to ensure code matches the provider's declared API surface.
• Use Case: Before implementing calls to Stripe, GitHub, Google, Twilio, or AWS, fetch the directory's openapi.yaml for the most recent API version to verify endpoints and auth requirements.

Quick Start

Use the openapi-directory to fetch the latest OpenAPI spec for stripe.com and summarize endpoints, required parameters, and auth schemes.