klh-openapi-directory-first

Look up authoritative OpenAPI specs for public APIs before relying on training data.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/klh/skills --skill klh-openapi-directory-first-klh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: klh-openapi-directory-first
Source: https://github.com/klh/skills/tree/main/.well-known/agent-skills/klh-openapi-directory-first
Command: npx skills add https://github.com/klh/skills --skill klh-openapi-directory-first-klh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Training data about public APIs goes stale quickly, leading to wrong endpoint paths, outdated parameter types, and incorrect auth assumptions. This Skill directs the agent to check the APIs-guru openapi-directory (2500+ machine-readable OpenAPI specs, auto-updated weekly) before consulting memory, doc sites, or Stack Overflow. ## Core Features & Use Cases - Spec-first lookup workflow: Search the openapi-directory by provider domain (stripe.com, github.com, googleapis.com, etc.), pick the latest version, and fetch the raw OpenAPI YAML from GitHub. - Structured extraction: Pull endpoint paths, request/response schemas, security schemes, and server base URLs directly from the spec instead of guessing. - Fallback guidance: Defines when to fall back to doc sites or context7 (API not in directory, GraphQL APIs, private APIs). - Use Case: When writing a Stripe integration, fetch the official OpenAPI spec to confirm exact parameter names, types, and auth scheme rather than relying on potentially outdated training knowledge. ## Quick Start Look up the current OpenAPI spec for the GitHub API in the openapi-directory and show me the correct endpoint and parameters for creating an issue.

Frequently Asked Questions about klh-openapi-directory-first

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the OpenAPI spec for a public API like Stripe or GitHub?

Search the APIs-guru openapi-directory on GitHub under APIs/{provider-domain}, pick the latest version folder, and fetch the openapi.yaml via raw.githubusercontent.com. The directory indexes 2500+ APIs with no API key required.

Why check an OpenAPI spec instead of relying on AI training data for API details?

Training data goes stale as APIs change endpoints, parameters, and auth schemes. OpenAPI specs in the directory are auto-updated weekly from original sources, making them the authoritative source of truth for signatures and schemas.

Does the openapi-directory support GraphQL APIs?

No. The directory only contains REST APIs in OpenAPI 2.0 and 3.x formats. For GraphQL APIs or private/internal APIs not listed, fall back to official documentation sites or tools like context7.

How do I check if an API exists in the openapi-directory?

Query https://api.apis.guru/v2/list.json and filter keys by the provider name. The response lists each API with its available versions, so you can select the most recent one.

What can I extract from an OpenAPI spec for integration work?

The spec provides all endpoint paths with methods and parameters, request/response data models under components/schemas, authentication schemes under security and securitySchemes, and base URLs under servers.