asyncapi-docs

# AsyncAPI Documentation Skill Generate and validate documentation for event-driven APIs using the AsyncAPI specification with support for multiple messaging protocols. ## Capabilities - Parse and validate AsyncAPI 2.x and 3.x specifications - Generate documentation from AsyncAPI specs - Document event/message schemas - Channel and operation documentation - Protocol-specific binding documentation (Kafka, MQTT, WebSocket, AMQP) - Code generator integration - Spectral linting for AsyncAPI - Schema validation and type generation ## Usage Invoke this skill when you need to: - Document event-driven microservices - Create message broker API documentation - Generate client code from async specifications - Validate AsyncAPI specifications - Create interactive documentation sites ## Inputs | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | specPath | string | Yes | Path to AsyncAPI specification | | outputDir | string | No | Documentation output directory | | generator | string | No | html, markdown, react (default: html) | | validate | boolean | No | Run spec validation (default: true) | | lint | boolean | No | Run Spectral linting (default: true) | | generateCode | boolean | No | Generate client/server stubs | | codeLanguage | string | No | Code generation target language | ### Input Example ```json { "specPath": "./asyncapi.yaml", "outputDir": "docs/async", "generator": "html", "validate": true, "lint": true, "generate...