mintlify

Configure Mintlify documentation sites with docs.json and MDX content.

19|3|Updated May 17, 2026
One-click install
npx skills add https://github.com/cline/skills --skill mintlify-cline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mintlify
Source: https://github.com/cline/skills/tree/main/skills/mintlify
Command: npx skills add https://github.com/cline/skills --skill mintlify-cline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Building and maintaining Mintlify documentation sites requires memorizing complex configuration syntax, component props, and navigation patterns, leading to time-consuming trial-and-error and inconsistent site structure. This skill eliminates that friction by providing a single, authoritative reference for all Mintlify features.

Core Features & Use Cases

  • Full Configuration Reference: Complete docs.json settings for themes, colors, SEO, integrations, and custom styling.
  • Component Syntax Guide: Detailed props and examples for all 24+ Mintlify components including callouts, tabs, cards, and API documentation elements.
  • Navigation & API Docs Setup: Step-by-step guidance for structuring site navigation, adding OpenAPI/AsyncAPI specs, and configuring interactive API playgrounds.
  • Use Case: If you are building a product documentation site for your SaaS tool, use this skill to quickly set up versioned navigation, add interactive API reference pages, and apply consistent branding without searching external Mintlify docs.

Quick Start

Use the mintlify skill to add a new API reference page with an interactive playground to your existing Mintlify documentation site.

Frequently Asked Questions about mintlify

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

FAQPage Schema
How do I configure docs.json for my Mintlify documentation site?

To configure docs.json for a Mintlify documentation site, you define settings for themes, colors, SEO, integrations, and custom styling within the file. This establishes a consistent site structure without requiring external lookups.

What is the correct syntax for Mintlify components in MDX content?

Mintlify components in MDX content use specific props and syntax for elements like callouts, tabs, cards, and API documentation. Using the correct component syntax ensures proper rendering and eliminates manual trial-and-error.

How do I set up an interactive API playground in Mintlify?

To set up an interactive API playground in Mintlify, you add OpenAPI or AsyncAPI specs and configure the API reference pages. This integration provides developers with functional, interactive endpoints directly within your product documentation.

Can I structure versioned navigation for a SaaS product documentation site?

You can structure versioned navigation for a SaaS product documentation site in Mintlify by configuring the navigation settings. This provides step-by-step guidance for organizing content hierarchies and applying consistent branding across versions.

Does Mintlify support OpenAPI and AsyncAPI specs for API references?

Mintlify supports both OpenAPI and AsyncAPI specs for generating API references. This allows you to quickly add interactive API reference pages and configure functional playgrounds directly from your specification files.

Why does my Mintlify site styling appear inconsistent across pages?

Mintlify site styling appears inconsistent across pages when docs.json configuration and component props are applied incorrectly. Using an authoritative reference for platform features ensures consistent styling, proper component usage, and functional navigation structure.