mintlify

Build Mintlify documentation sites from MDX files and OpenAPI specs.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/victor-brechbill/claw-kernel --skill mintlify-victor-brechbill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mintlify
Source: https://github.com/victor-brechbill/claw-kernel/tree/main/.agents/skills/mintlify
Command: npx skills add https://github.com/victor-brechbill/claw-kernel --skill mintlify-victor-brechbill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of creating, managing, and maintaining documentation websites using the Mintlify platform, ensuring consistency and adherence to best practices.

Core Features & Use Cases

  • Documentation Site Generation: Transforms MDX files into professional documentation sites.
  • Configuration Management: Assists in configuring site-wide settings via docs.json.
  • Content Organization: Helps structure navigation, organize pages, and manage links.
  • Component Utilization: Guides the use of Mintlify's built-in components for rich content.
  • API Documentation: Facilitates the generation of API reference pages from OpenAPI specifications.
  • Use Case: You need to add a new "Getting Started" guide to an existing Mintlify documentation site, ensuring it's correctly linked in the navigation and follows the established style.

Quick Start

Use the mintlify skill to add a new page titled "Contributing Guidelines" to the documentation site, placing it within the "Developer" section of the navigation.

Frequently Asked Questions about mintlify

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

FAQPage Schema
How do I build a documentation site from MDX files?

To build a documentation site from MDX files, you can use Mintlify to transform your MDX content into a professional, hosted website while managing site-wide settings through a central configuration file.

How do I generate API reference pages from an OpenAPI specification?

Generating API reference pages from an OpenAPI specification is supported natively, allowing you to automatically create interactive API documentation directly from your existing OpenAPI definition files.

What is the best way to organize navigation for a Mintlify documentation site?

The best way to organize navigation for a Mintlify documentation site is by structuring your pages and links within the site-wide configuration file, ensuring logical grouping and accessible content hierarchies.

Can I use built-in components for rich content in MDX documentation?

Yes, you can use built-in components within your MDX files to render rich content elements, enabling interactive and structured layouts beyond standard markdown formatting for your documentation.

Do I need a specific configuration file to manage site-wide documentation settings?

You need a docs.json configuration file to manage site-wide documentation settings, which controls global configurations, navigation structures, and page organization across your entire Mintlify site.

How do I add a new guide to an existing documentation site and link it correctly?

To add a new guide to an existing documentation site, create the MDX file and register it within the navigation structure of your configuration file to ensure it is properly linked and styled.