mintlify

Generate and deploy Mintlify documentation websites from Markdown/MDX and API specs.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/hoanghd218/docons --skill mintlify-hoanghd218
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mintlify
Source: https://github.com/hoanghd218/docons/tree/main/landingpage-app-render/.opencode/skills/mintlify
Command: npx skills add https://github.com/hoanghd218/docons --skill mintlify-hoanghd218

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation, customization, and deployment of professional documentation websites, making it easy to build developer portals, knowledge bases, and API docs.

Core Features & Use Cases

  • Content Creation: Write docs in Markdown/MDX with rich components.
  • API Documentation: Auto-generate from OpenAPI/AsyncAPI specs.
  • Customization: Theme, brand, and configure navigation extensively.
  • AI Integration: Leverage AI for search, content generation, and agent readiness.
  • Deployment: Seamless integration with Git platforms and hosting services.
  • Use Case: A software company needs to create a comprehensive developer portal for its new API. This Skill can be used to generate API reference docs from an OpenAPI spec, write guides in MDX, customize the look and feel to match their brand, and deploy it automatically on every push to their main branch.

Quick Start

Use the mintlify skill to build and deploy documentation.

Frequently Asked Questions about mintlify

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

FAQPage Schema
How do I build and deploy a developer portal from OpenAPI specs?

To build and deploy a developer portal, this Skill auto-generates API reference docs from OpenAPI/AsyncAPI specs, lets you write guides in MDX, and automates deployment through Git-based integrations on every push to your main branch.

Can I use MDX to create a customized knowledge base with AI search?

Yes, you can create a customized knowledge base using MDX content. This Skill supports extensive theming and brand configuration while leveraging AI integration to enable search and content generation for your documentation site.

What is the best way to generate API documentation from an AsyncAPI spec?

The best way to generate API documentation from an AsyncAPI spec is using this Skill's automated spec integration, which parses the file to automatically create structured reference docs alongside your MDX guides.

Does this documentation site generator support automated Git-based deployments?

Yes, this documentation site generator supports automated Git-based deployments. It integrates seamlessly with Git platforms and hosting services to automatically build and deploy updates on every push.

How do I customize navigation and branding for a developer documentation site?

You can customize navigation and branding for a developer documentation site using this Skill's extensive configuration options, allowing you to extensively theme the portal and align the layout with your brand identity.

What are the limitations of building documentation sites with Markdown and MDX?

Building documentation sites with Markdown and MDX requires structuring content within supported components and configuration formats, meaning custom layouts outside the provided theming and component system may not be supported natively.