mintlify

Build Mintlify documentation sites by authoring MDX pages and configuring docs.json navigation.

5|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/ophidiarium/mehen --skill mintlify-ophidiarium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mintlify
Source: https://github.com/ophidiarium/mehen/tree/main/.agents/skills/mintlify
Command: npx skills add https://github.com/ophidiarium/mehen --skill mintlify-ophidiarium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mintlify helps you consistently build and maintain documentation sites from MDX content so your pages, navigation, and components stay coherent as the docs grow.

Core Features & Use Cases

  • Docs-site setup and governance: Standardize site-wide configuration via docs.json so navigation, theme, integrations, and behavior remain predictable.
  • MDX authoring conventions: Write documentation pages with required frontmatter (including title) and optional SEO/navigation fields.
  • Correct navigation and organization: Organize content using Mintlify navigation patterns (groups, tabs, anchors, dropdowns, products, versions, languages) and ensure new pages appear by updating docs.json.

Quick Start

Use the mintlify skill to update docs.json navigation and write a new MDX page with required title and description frontmatter that matches your existing site structure.

Frequently Asked Questions about mintlify

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

FAQPage Schema
How do I add a new page to my Mintlify documentation site?

To add a new page to your Mintlify documentation site, author an MDX file with required title and description frontmatter, then update the site's docs.json navigation structure to ensure the page appears in the sidebar or tabs.

What frontmatter is required for MDX pages in Mintlify?

Required MDX frontmatter for Mintlify pages includes a title and description for SEO. Optional navigation fields can also be added to control page grouping and ordering within the site structure.

How do I organize sidebar navigation and tabs using docs.json?

Organize sidebar navigation and tabs by configuring groups, anchors, and dropdowns within the docs.json file. Updating this root configuration structure ensures new pages are discoverable and grouped correctly.

Can I use Mintlify components and API references in my MDX documentation?

Yes, you can embed Mintlify components and API references directly within MDX pages. Adhering to component usage conventions and root-relative internal links ensures they render correctly and maintain site coherence.

Why are my internal documentation links broken after adding new pages?

Broken internal links often occur when paths are not root-relative. Mintlify requires correct root-relative internal links in MDX content, along with corresponding docs.json navigation updates, to ensure links resolve properly.

Does Mintlify support multi-version or multi-language documentation sites?

Yes, Mintlify supports multi-version and multi-language documentation sites. You can configure versions, languages, and products within the docs.json file to organize and serve localized or version-specific content.