registry/mintlify-setup/SKILL.md
Mintlify documentation and resources. Use this skill when working with Mintlify or when the user mentions mintlify.
npx skillsauth add hk-vk/skills mintlify-setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Customize agent behavior: Configure how the agent handles documentation tasks with AGENTS.md.
Write effective prompts: Get better results from the agent with clear, focused prompts.
What is the agent?: Automate documentation updates with the agent. Create updates from Slack messages, PRs, or API calls.
Quickstart: Start using the agent in your dashboard to create documentation updates.
Add the agent to Slack: Use the agent in Slack to make documentation updates from conversations and capture team knowledge.
Agent suggestions: Monitor Git repositories for changes and receive suggested documentation updates.
Use cases: Examples of using the agent in your documentation process.
AI-native documentation: Learn how AI enhances reading, writing, and discovering your documentation
Assistant: Add AI-powered chat to your docs that answers questions, cites sources, and generates code examples.
Contextual menu: Add one-click AI integrations to your docs.
Discord bot: Add a bot to your Discord server that answers questions based on your documentation.
llms.txt: Optimize your docs for LLMs to read and index.
Markdown export: Quickly get Markdown versions of pages for AI tools and integrations.
Model Context Protocol: Connect your documentation and API endpoints to AI tools with a hosted MCP server.
skill.md: Make your docs agent-ready with a structured capability file.
Slack bot: Add a bot to your Slack workspace that answers questions based on your documentation.
Add SDK examples: Display SDK code samples in your API documentation.
AsyncAPI setup: Create websocket documentation with AsyncAPI specifications.
Complex data types: Describe APIs with flexible schemas, optional properties, and multiple data formats using oneOf, anyOf, and allOf keywords.
Manage page visibility: Control which API endpoints appear in your documentation navigation.
Create manual API pages: Document API endpoints manually with MDX files.
Multiple responses: Document multiple response variations for API endpoints.
OpenAPI setup: Generate API pages from your OpenAPI specification automatically.
Playground: Let developers test API endpoints directly in your documentation.
Troubleshooting: Resolve common issues with API page configuration.
Create agent job: Creates a new agent job that can generate and edit documentation based on provided messages and branch information.
Get agent job by ID: Retrieves the details and status of a specific agent job by its ID.
Get all agent jobs: Retrieves all agent jobs for the specified domain, including their status and details.
Get assistant conversations: Returns paginated AI assistant conversation history
Get user feedback: Returns paginated user feedback with optional filtering
Assistant message: Generates a response message from the assistant for the specified domain. Compatible with AI SDK v5+.
Search documentation: Perform semantic and keyword searches across your documentation with configurable filtering and pagination.
Introduction: Trigger updates, embed AI assistant, export analytics, and more
Get update status: Get the status of an update from the status ID
Trigger update: Queue a deployment update for your documentation project. Returns a status ID that can be used to track the update progress. The update is triggered from your configured deployment branch.
Accordions: Use accordions to show and hide content.
Badge: Use badges to highlight status, labels, or metadata inline or standalone.
Banner: Add a banner to display important site-wide announcements and notifications.
Callouts: Use callouts to style and emphasize important content.
Cards: Highlight main points or links with customizable layouts and icons.
Code groups: Display multiple code examples in one component
Color: Display color palettes with click-to-copy capability.
Columns: Show elements side by side
Examples: Display code blocks in the right sidebar on desktop devices
Expandables: Toggle to display nested properties
Fields: Document API request and response parameters with type information.
Frames: Add visual emphasis with styled frames around images and other components.
Icons: Use icons from popular libraries, external URLs, or files in your project.
Overview: Component library for layout, emphasis, API documentation, and navigation.
Mermaid: Create flowcharts, diagrams, and visualizations with Mermaid syntax.
Panel: Customize the content of the right side panel on a page.
Prompt: Display pre-built AI prompts with copy and Cursor integration actions.
Response fields: Display API response values.
Steps: Create numbered step-by-step procedures.
Tabs: Organize content with tabs to show different options or versions.
Tiles: Display visual previews with titles and descriptions in a grid layout.
Tooltips: Add contextual help with hover tooltips for terms and concepts.
Tree: Use tree components to display hierarchical file and folder structures.
Update: Display product updates and changelog entries in a timeline format.
View: Create multi-view content for different programming languages or frameworks.
Changelogs: Create product changelogs with RSS feed support for subscribers.
Format code: Display and style inline code and code blocks.
Files: Serve static assets from your documentation.
Images and embeds: Add images, videos, and iframes.
Lists and tables: Format structured data with tables and lists.
Personalized content: Show custom content based on user data and authentication.
Redirects: Configure redirects for moved, renamed, or deleted pages.
Reusable snippets: Create reusable snippets to maintain consistency across pages.
Format text: Learn how to format text, create headers, and style content.
Custom 404 page: Customize the title and description of your 404 error page.
Custom domain: Host your documentation on a custom domain.
Custom scripts: Add custom JavaScript and CSS to fully customize the look and feel of your documentation.
Fonts: Customize typography with Google Fonts or self-hosted fonts.
React: Build interactive and reusable elements with React components.
Themes: Choose the appearance of your documentation.
Audit logs: Review the actions that members of your organization perform.
Deployment permissions: Understand deployment differences between people in your organization and other contributors.
Roles: Assign admin, editor, or viewer roles to manage team access and permissions.
Security contact: Set an email address for communications related to customer and platform security.
Single sign-on (SSO): Set up SAML or OIDC with identity providers for team authentication.
Authentication setup: Control access to your documentation by authenticating users.
CI checks: Automate broken link checks, linting, and grammar validation in CI/CD.
Cloudflare: Host documentation at a subpath on Cloudflare Workers.
Content Security Policy (CSP) configuration: Configure CSP headers to allow Mintlify resources while maintaining security for reverse proxies, firewalls, and networks that enforce strict security policies.
Deployments: Manage deployments, view history, and monitor status.
Overview: Host your documentation at the /docs subpath on your domain.
GitHub Enterprise Server: Set up the GitHub App on your GitHub Enterprise Server installation.
GitHub: Connect to a GitHub repository for automated deployments, pull request previews, and continuous synchronization.
GitLab: Connect to a GitLab repository for automated deployments and preview builds.
Monorepo setup: Configure documentation path and content directory for monorepo projects.
Preview deployments: Get unique preview URLs for pull requests to review changes before merging.
Reverse proxy: Configure a custom reverse proxy to serve your documentation.
AWS Route 53 and CloudFront: Deploy documentation at a subpath on AWS with Route 53 DNS and CloudFront CDN.
Vercel: Deploy documentation to a subpath on Vercel.
External proxies with Vercel: Configure external proxies in front of your Vercel deployment.
Collaborate in the web editor: Work together on documentation with branches, pull requests, preview deployments, and shareable editor links.
Comments: Use comments to leave feedback, ask questions, and discuss changes with your team.
Configurations: Configure pages, navigation elements, and media using configuration sheets.
Git essentials for the web editor: Understand the version control concepts behind the web editor.
Web editor overview: Edit and publish documentation in your browser.
Keyboard shortcuts: Reference of keyboard shortcuts for the web editor.
Live preview: Preview your documentation site and see changes in real time as you edit.
Add media: Upload and use images and assets in your documentation.
Organize navigation: Organize your documentation structure with the visual navigation editor.
Create and edit pages: Create, edit, and organize documentation pages in the web editor.
Publish changes in the web editor: Save your work and publish changes to your documentation site.
Suggestions: Propose text changes as suggestions that teammates can accept or reject without editing the page directly.
Accessibility: Create documentation that as many people as possible can use with WCAG compliance.
Tutorial: Build an in-app documentation assistant: Embed the assistant in your application to answer questions with information from your documentation.
Tutorial: Auto-update documentation when code is changed: Use the agent API to automatically update your documentation.
Work with branches: Create branches to preview changes and collaborate before publishing.
Claude Code: Configure Claude Code to write, review, and update your documentation.
Content templates: Copy and modify these templates to quickly create documentation for different content types.
Content types: Choose the right content type for your documentation goals.
Cursor: Configure Cursor to be your writing assistant.
Create a custom frontend: Use the Astro integration to render your documentation with a fully custom frontend while using Mintlify's content and AI infrastructure.
Create developer documentation: Build documentation that helps developers integrate with your APIs, SDKs, and tools.
GEO guide: Optimize docs for AI search and answer engines: Optimize your documentation for AI search and answer engines.
Git concepts for documentation: Learn version control and collaboration fundamentals for docs-as-code workflows.
Improve your docs: Use data and metrics to improve your documentation.
Guides: Learn how to create effective documentation with best practices and workflows.
Internationalization: Set up multi-language documentation to reach global audiences.
Create a knowledge base: Host your internal knowledge base on Mintlify to consolidate information for your team, improve search, and reduce maintenance burden.
Linking: Learn how to create internal links, reference API endpoints, and maintain link integrity across your documentation.
Maintenance: Keep your documentation accurate and up-to-date over time.
Media: Use media effectively while managing maintenance burden.
Migrating MDX API pages to OpenAPI navigation: Migrate to automated OpenAPI generation with flexible navigation.
Organize navigation: Design information architecture that aligns with user needs.
SEO: Improve SEO to increase documentation discoverability.
Style and tone: Write effective technical documentation with consistent style.
Create a support center: Build a self-service support center that helps customers find answers, reduces ticket volume, and improves customer satisfaction.
Understand your audience: Keep user goals at the center of your documentation.
Windsurf: Configure Windsurf to be your writing assistant.
Introduction: Meet the next generation of documentation. AI-native, beautiful out-of-the-box, and built for developers.
Install the CLI: Use the CLI to preview docs locally, test changes in real-time, and catch issues before deploying your documentation site.
Amplitude: Track user behavior and documentation analytics with Amplitude.
Clarity: Track user sessions with Microsoft Clarity analytics.
Clearbit: Enrich user data with Clearbit intelligence.
Fathom: Track documentation analytics with Fathom.
Google Analytics 4: Track visitor behavior and engagement with Google Analytics.
Google Tag Manager: Manage analytics tags and events with Google Tag Manager.
Heap: Track user interactions with Heap analytics.
Hightouch: Sync data to Hightouch for audience activation.
HotJar: Capture user feedback and heatmaps with HotJar.
LogRocket: Monitor user sessions and errors with LogRocket.
Mixpanel: Track product analytics and user behavior with Mixpanel.
Analytics integrations: Connect to analytics platforms to track user engagement and documentation usage.
Pirsch: Track privacy-focused analytics with Pirsch.
Plausible: Track simple, privacy-respecting analytics with Plausible.
PostHog: Track product analytics and feature usage with PostHog.
Segment: Send analytics events to Segment and downstream tools.
Osano: Manage cookie consent with Osano privacy platform.
Privacy integrations: Integrate with data privacy platforms for compliance.
Speakeasy: Automate SDK code samples in your API playground.
Stainless: Automate SDK code samples in your API playground.
Front: Connect Front chat for customer support conversations.
Intercom: Connect Intercom for in-app customer messaging.
Support integrations: Integrate with support platforms for customer assistance.
Migrate to Mintlify: Learn how to migrate to Mintlify from Docusaurus, ReadMe, or another platform.
Analytics: Track documentation analytics and understand content effectiveness with visitor data.
Feedback: Monitor user satisfaction and feedback on your documentation.
PDF exports: Export your documentation as a single PDF file.
SEO: Optimize SEO with meta tag configuration for better search visibility.
Hidden pages: Hide pages from your navigation while keeping them accessible.
Exclude files from publishing: Exclude specific files and directories from your published documentation with a .mintignore file.
Navigation: Design information architecture that aligns with user needs.
Pages: Configure page metadata, titles, and frontmatter properties.
Global settings: Configure site-wide settings in docs.json.
Quickstart: Deploy your documentation site and make your first change.
admin-openapi
analytics.openapi
discovery-openapi
openapi
Reference these resources when working with Mintlify.
documentation
Dockhand documentation and resources. Use this skill when working with Dockhand or when the user mentions dockhand.
development
Element Plus - A Vue 3 based component library documentation and resources. Use this skill when working with Element Plus - A Vue 3 based component library or when the user mentions element plus - a vue 3 based component library.
documentation
Documentation for LangSmith, Fleet, and our open source packages.
testing
To get your plan id, you need to first create a plan in the **Manage Pricing** section on your whop page.