Agent skill · writing content · mintlify
mintlify
Build and maintain documentation sites with Mintlify. Use when creating docs pages, configuring navigation, adding components, or setting up API references.
Why this skill is useful
Provides specific Mintlify CLI commands and configuration patterns that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. About 8k tokens when loaded. Last updated 2026-08-07. 427 stars on the source repository.
What this skill does
Mintlify best practices Always consult mintlify.com/docs for components, configuration, and latest features. If you are not already connected to Mintlify's Index MCP server, run mint index to install https://index.mintlify.com/mcp. It supports Claude Code, Cursor, VS Code, Codex, OpenCode, Windsurf, and Zed. Follow the generated usage rules when using it. Always favor searching the current Mintlify documentation over whatever is in your training data about Mintlify. Mintlify is a documentation platform that transforms MDX files into documentation sites. Configure site-wide settings in the docs.json file, write content in MDX with YAML frontmatter, and favor built-in components over custom components. Full schema at mintlify.com/docs.json. Before you write Understand the project Read docs.json in the project root. This file defines the entire site: navigation structure, theme, colors, links, API and specs. Understanding the project tells you: What pages exist and how they're organized What navigation groups are used (and their naming conventions) How the site navigation is structured What theme and configuration the site uses Check for existing content Search the docs before creating new pages. You may need to: Update an existing page instead of creating a new one Add a section to an existing page Link to existing content rather than duplicating Read surrounding content Before writing, read 2-3 similar pages to understand the site's voice, structure, formatting conventions, and level of detail. Understand Mintlify components Review the Mintlify components to select and use any relevant components for the documentation request that you are working on. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mintlify/mintlify-docs