mintlify skill

---
name: "mintlify-docs"
description: "Scraped from https://mintlify.com/docs/ Source: https://mintlify.com/docs/. Use when questions involve: agent, ai, api playground, api reference, authentication personalization, components."
---

# Mintlify Docs

> Official documentation: https://mintlify.com/docs/

## Overview

This skill provides comprehensive documentation for mintlify docs.

**Total references:** 24 files (~232,992 tokens)

**Topics covered:**
Preview distribution, Iterate on a prompt in a Slack thread, Inline usage, Global meta tags, Manually trigger a deployment, Sizes, Demo, Session recordings, Groups, Create snippets, User research is key, Automatically generated meta tags...

## Reference Files

Load only the reference files relevant to the user's question:

### Agent

- **[Customize agent behavior and more](references/agent.md)** (~3,178 tokens)
  - Topics: What to include in AGENTSmd, Example AGENTSmd file, Code examples

### Ai

- **[Assistant and more](references/ai.md)** (~7,705 tokens)
  - Topics: About the assistant, Configure the assistant, Manage billing

### Api Playground

- **[Add SDK examples and more](references/api-playground.md)** (~6,259 tokens)
  - Topics: Demo, Add an AsyncAPI specification file, Auto-populate websockets pages

### Api Reference

- **[Create agent job and more](references/api-reference.md)** (~1,713 tokens)
  - Topics: Usage, Job details, Usage

### Authentication Personalization

- **[Authentication setup](references/authentication-personalization.md)** (~2,229 tokens)
  - Topics: Configure authentication, Make pages public, Control access with groups

### Components

- **[Accordions and more](references/components.md)** (~7,446 tokens)
  - Topics: Single accordion, Accordion Groups, Properties

### Create

- **[Changelogs and more](references/create.md)** (~5,898 tokens)
  - Topics: Setting up your changelog, Customizing your changelog, Adding code samples

### Customize

- **[Custom 404 page and more](references/customize.md)** (~3,342 tokens)
  - Topics: Configuration, Parameters, Add your custom domain

### Dashboard

- **[Audit logs and more](references/dashboard.md)** (~1,821 tokens)
  - Topics: View audit logs, Export audit logs, Add editors

### Deploy

- **[Authentication setup and more](references/deploy-1.md)** (~7,891 tokens)
  - Topics: Configure authentication, Make pages public, Control access with groups
- **[Preview deployments and more](references/deploy-2.md)** (~3,578 tokens)
  - Topics: Create preview deployments, Redeploy a preview, Preview widget

### Editor

- **[Collaborate in the web editor and more](references/editor.md)** (~5,538 tokens)
  - Topics: Branch-based collaboration, Recommended workflow, Preview deployments

### General

- **[What is the agent? and more](references/general-1.md)** (~1,534 tokens)
  - Topics: What makes your documentation AI-native, Enable AI features, Overview
- **[Product updates](references/general-2.md)** (~12,221 tokens)
  - Topics: skillmdauto-generation, Audit logs for authentication events, Markdown export for agents
- **[Overview and more](references/general-3.md)** (~1,401 tokens)
  - Topics: Structure your content, Draw attention, Show and hide content
- **[Customize agent behavior](references/general-4.md)** (~116,355 tokens)
  - Topics: What to include in AGENTSmd, Example AGENTSmd file, Code examples
- **[Mintlify and more](references/general-5.md)** (~7,803 tokens)
  - Topics: Docs, Choose your migration path, Automated migration

### Guides

- **[Accessibility and more](references/guides-1.md)** (~7,403 tokens)
  - Topics: What is accessibility, Getting started with accessibility, Structure your content
- **[Content types and more](references/guides-2.md)** (~7,094 tokens)
  - Topics: Categorize using the Diátaxis framework, Picking a type, Writing for each type
- **[Internationalization and more](references/guides-3.md)** (~5,761 tokens)
  - Topics: File structure, Configure the language switcher, Maintain translations

### Integrations

- **[Amplitude and more](references/integrations.md)** (~3,373 tokens)
  - Topics: Get your project ID, How to Connect GA4 to Mintlify, Tracked events

### Optimize

- **[Analytics and more](references/optimize.md)** (~3,146 tokens)
  - Topics: Visitors, Assistant, Searches

### Organize

- **[Hidden page example and more](references/organize-1.md)** (~4,539 tokens)
  - Topics: Common use cases for hidden pages, Examples, Hiding a page
- **[Global settings](references/organize-2.md)** (~5,764 tokens)
  - Topics: Setting up yourdocsjson, Reference, Examples

## Usage Guidelines

1. **Identify relevant sections** - Match the user's question to the appropriate reference file(s)
2. **Load minimally** - Only read files directly relevant to the question to conserve context
3. **Cite sources** - Reference specific sections when answering
4. **Combine knowledge** - For complex questions, you may need multiple reference files

### When to use each reference:

- **Agent**: Agent-related features and documentation
- **Ai**: AI features and third-party integrations
- **Api Playground**: API endpoints, parameters, responses, and examples
- **Api Reference**: API endpoints, parameters, responses, and examples
- **Authentication Personalization**: Authentication Personalization-related features and documentation
- **Components**: UI components, styling, and visual elements
- **Create**: Creating and managing content
- **Customize**: Configuration, customization, and settings
- **Dashboard**: Dashboard-related features and documentation
- **Deploy**: Deployment, hosting, and infrastructure
- **Editor**: Editor-related features and documentation
- **General**: General documentation, overview, and getting started
- **Guides**: Guides-related features and documentation
- **Integrations**: AI features and third-party integrations
- **Optimize**: Optimize-related features and documentation
- **Organize**: Organize-related features and documentation