ck:mintlify

Build Mintlify documentation sites from MDX with OpenAPI/AsyncAPI integration.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/MinhQuyen274/smartify --skill ck-mintlify-minhquyen274
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ck:mintlify
Source: https://github.com/MinhQuyen274/smartify/tree/main/Frontend_PROJECT_Figma/.opencode/skills/mintlify
Command: npx skills add https://github.com/MinhQuyen274/smartify --skill ck-mintlify-minhquyen274

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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."

Frequently Asked Questions about ck:mintlify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate API documentation from an OpenAPI spec?

Generate interactive API documentation and playgrounds directly from OpenAPI or AsyncAPI specs. The system validates your OpenAPI definitions and automatically creates example requests and API reference pages.

How do I build a multi-language documentation site with MDX?

Build multi-language documentation sites by configuring navigation, theming, and page frontmatter in MDX. You can structure content using tabbed docs, grouped pages, anchors, and dropdown menus.

Can I configure multi-product and multi-version navigation in Mintlify?

Yes, you can configure multi-product and multi-version navigation using the docs.json configuration file. This supports structured organization with tabbed docs, anchors, dropdown menus, and language switching.

How do I make my documentation AI-ready for agents and MCP integrations?

Make documentation AI-ready by generating artifacts like llms.txt and skill.md files. The system supports MCP exposure and agent tooling integrations to make your docs accessible to AI features.

What's the best way to validate documentation for broken links and OpenAPI errors?

Validate documentation using built-in workflows that check for broken links, accessibility issues, and OpenAPI spec errors. These validation checks can be automated through GitHub or GitLab CI/CD deployments.

Does Mintlify work with AsyncAPI specs for event-driven API documentation?

Yes, AsyncAPI specs are fully supported alongside OpenAPI for generating event-driven API documentation. The system processes both formats to create interactive playgrounds and API reference pages.