import-api-spec

What problem does it solve?

OpenAPI, GraphQL, and AsyncAPI specifications are often scattered, inconsistent, and hard to publish. This Skill imports, validates, and organizes API specs into a consistent documentation-ready structure.

Core Features & Use Cases

• Import and classify API specs by type (OpenAPI, GraphQL, AsyncAPI) based on file patterns.
• Validate syntax, resolve $ref references, and extract servers, security, and endpoints.
• Generate a documentation scaffold under api-reference including introduction, authentication, errors, and rate-limiting sections.
• Use Case: A team receives multiple specs from vendors; this Skill consolidates them into a single, coherent API reference ready for publishing.

Quick Start

Place your spec files (openapi.yaml, swagger.yaml, schema.graphql, or asyncapi.yaml) in a folder and run the skill to produce the api-reference scaffold.