What problem does it solve?
This Skill helps you turn Markdown/MDX documentation (plus optional OpenAPI/AsyncAPI specs) into a polished, navigable, production-ready documentation site—complete with validation, deployments, and AI-ready metadata.
Core Features & Use Cases
- Docs site generation: Converts MDX into interactive documentation with configurable theming and page frontmatter.
- Structured navigation & organization: Builds tabbed docs, grouped pages, anchors, dropdown menus, products, versions, and languages.
- API documentation support: Generates API docs and interactive playgrounds from OpenAPI/AsyncAPI, including example generation and OpenAPI validation.
- AI-ready documentation: Supports AI features such as
llms.txt, skill.md, and MCP exposure for agent tooling.
- Deployment & CI/CD: Enables automated deployments (GitHub/GitLab) and validation workflows (broken links, a11y, OpenAPI checks).
Quick Start
Tell your AI: "Set up Mintlify docs with a docs.json theme, add navigation for Getting Started and API Reference, validate the config, and generate API pages from my OpenAPI spec."