asyncapi-docs
AsyncAPI specification handling for event-driven API documentation. Parse, validate, and generate documentation for message-based APIs including Kafka, MQTT, WebSocket, and AMQP systems.
npx skills add a5c-ai/babysitter --skill asyncapi-docs --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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)
- Capabilities
- Usage
- Inputs
- Input Example
- Output Structure
- AsyncAPI Specification Patterns
- Basic AsyncAPI 3.0 Document
- Kafka-Specific Bindings
- WebSocket Channel
- MQTT Channel
- AsyncAPI CLI Commands
- Validation
- Documentation Generation
- Code Generation
Validate specification asyncapi validate asyncapi.yaml Validate with custom rules asyncapi validate asyncapi.yaml --rule-file .spectral.yaml Generate HTML documentation asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template -o docs Generate Markdown asyncapi generate fromTemplate asyncapi.yaml @asyncapi/markdown-template -o docs Generate React app asyncapi generate fromTemplate asyncapi.yaml @asyncapi/react-component -o docs
What does the asyncapi-docs skill do?
AsyncAPI specification handling for event-driven API documentation. Parse, validate, and generate documentation for message-based APIs including Kafka, MQTT, WebSocket, and AMQP systems.
How do I install it?
Run `npx skills add a5c-ai/babysitter --skill asyncapi-docs --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From a5c-ai/babysitter, a repository with 1,642 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.