mintlify

Automate Mintlify documentation site creation and maintenance across Git workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mintlify enables teams to build and maintain consistent documentation sites by automating page structure, navigation, and component usage.

Core Features & Use Cases

  • Create and organize pages with consistent frontmatter and MDX structure.
  • Configure navigation and theming via docs.json for scalable docs sites.
  • Generate and maintain API reference pages, OpenAPI integration, and component docs.

Quick Start

Use Mintlify to scaffold and maintain documentation pages, navigation, and components.

Frequently Asked Questions about mintlify

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

FAQPage Schema
How do I create Mintlify documentation pages with consistent frontmatter and MDX structure?

Mintlify documentation pages require consistent YAML frontmatter and MDX structure to render properly. Automating page creation ensures these formatting standards are met across your entire documentation site, preventing manual syntax errors.

How do I configure navigation and theming for a Mintlify docs site?

Configuring navigation and theming for a Mintlify docs site is managed through the docs.json file. This central configuration allows you to scale your documentation by organizing page hierarchies and applying consistent visual themes.

How do I generate and maintain API reference pages in Mintlify?

Generating API reference pages in Mintlify involves integrating your OpenAPI specifications and configuring component docs. This automated process maintains your API references accurately across a Git-based workflow without manual page updates.

Can I use Mintlify CLI workflows to manage documentation within a Git-based workflow?

Yes, Mintlify CLI workflows are designed to manage documentation sites within a Git-based workflow. This allows your team to scaffold, update, and maintain docs pages, navigation, and components directly through version control.

What is the best way to organize documentation components for a scalable docs site?

The best way to organize documentation components for a scalable docs site is by standardizing MDX structures and centralizing configuration. Using tools like Mintlify automates this organization, ensuring consistent component usage and navigation.

Why does my Mintlify page structure break when updating docs.json?

Your Mintlify page structure breaks when docs.json is misconfigured or MDX frontmatter is invalid. Maintaining proper navigation settings and consistent page frontmatter prevents these structural issues from disrupting your documentation site.