api-artifacts

What problem does it solve?

This Skill automates the generation of comprehensive API artifacts (OpenAPI specs, Postman collections, AsyncAPI specifications, and GraphQL schemas) from architecture manifests, eliminating manual replication and drift across documentation and testing artifacts.

Core Features & Use Cases

• OpenAPI 3.1 generation: Derives a per-service REST API spec from responsibilities and shared types.
• Postman collection generation: Produces ready-to-use collections for API testing with environment variables and sample requests.
• AsyncAPI generation: Creates event-driven interface specs for all message channels defined in the manifest.
• GraphQL schema generation: Generates GraphQL schemas and input types from shared contracts and service definitions.
• Template-driven output: Ensures consistent naming, versions, and examples across artifacts.

Use Case: When you have a multi-service architecture described in a manifest, generate all necessary API artifacts in one pass to accelerate integration and testing.

Quick Start

Use this skill to generate OpenAPI, Postman, AsyncAPI, and GraphQL artifacts from your manifest file (e.g., manifest.yaml). The artifacts will be output to an artifacts/ directory and include openapi.yaml, postman-collection.json, asyncapi.yaml, and graphql-schema.graphql.