mintlify · ethanpalm · Apr 29, 2026 · Apr 28, 2026 · Apr 29, 2026 · cursor
diff --git a/agent/index.mdx b/agent/index.mdx
@@ -41,6 +41,18 @@ By default, the agent opens pull requests attributed to the Mintlify bot. To att
 
 The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the agent panel **Settings** or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new).
 
+## Use AI tools alongside the agent
+
+The agent works asynchronously through pull requests, but you can also use AI coding tools like Cursor or Claude Code locally for fast, iterative edits. Install the Mintlify [skill](/ai/skillmd) and connect the [MCP server](/ai/model-context-protocol) so your editor has the same context the agent uses.
+
+<Prompt description="Install the Mintlify skill and MCP server for AI coding tools." actions={["copy", "cursor"]}>
+Install the Mintlify skill to get context on Mintlify project structure, components, and documentation best practices:
+
+npx skills add https://mintlify.com/docs
+
+Then add the Mintlify MCP server for access to documentation search. Follow the setup instructions at https://www.mintlify.com/docs/ai/model-context-protocol.md
+</Prompt>
+
 ## Next steps
 
 <Card title="Connect Slack" horizontal icon="slack" href="/agent/slack">

diff --git a/ai-native.mdx b/ai-native.mdx
@@ -27,6 +27,16 @@ Your site is automatically optimized for AI tools and search engines to help use
 
 Mintlify hosts `llms.txt` and `skill.md` files for your documentation. These industry-standard files help LLMs respond efficiently with relevant information to user queries and provide a list of capabilities for agents to use, so that users are more successful with your product.
 
+<Tip>
+  Teach your users how to install your `skill.md` file so they get better results when using your product with AI tools. Embed an installation prompt directly in your docs with the [`Prompt` component](/components/prompt):
+
+  ```mdx
+  <Prompt description="Install the skill for your product." actions={["copy", "cursor"]}>
+  npx skills add https://your-docs-domain.com
+  </Prompt>
+  ```
+</Tip>
+
 Your documentation site also hosts an MCP server that lets users connect your documentation directly to their AI tools for up-to-date information about your product directly where they want it.
 
 Full-text search and semantic understanding help users and AI tools find relevant information quickly. Search understands user intent rather than just matching keywords. And if a user encounters a 404 error, your site suggests related pages to help them find what they're looking for. No configuration required.

diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx
@@ -9,6 +9,10 @@ import IconsRequired from "/snippets/icons-required.mdx";
 
 The contextual menu provides quick access to AI-optimized content and direct integrations with popular AI tools. When users select the contextual menu on any page, they can copy content as context for AI tools or open conversations in ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Windsurf, or a custom tool of your choice with your documentation already loaded as context.
 
+<Tip>
+  Pair the contextual menu with your hosted [`skill.md`](/ai/skillmd) file and [MCP server](/ai/model-context-protocol) so that users can install your product's full capabilities into their AI tools, not just the page they are reading.
+</Tip>
+
 ## Menu options
 
 The contextual menu includes several pre-built options that you can enable by adding their identifier to your configuration.

diff --git a/assistant/index.mdx b/assistant/index.mdx
@@ -5,7 +5,7 @@
 ---

 <Info>
  The assistant is available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=assistant) and is enabled by default for those plans.
 </Info>

 ## About the assistant
@@ -59,3 +59,7 @@
   - Cross-reference related topics.
   - Add [hidden pages](/organize/hidden-pages) with additional context that users don't need, but the assistant can reference.
 </Card>
+
+<Tip>
+  Use the [`Visibility`](/components/visibility) component to tailor content for human readers and AI tools on the same page. Wrap UI-oriented content in `<Visibility for="humans">` and API-oriented or agent-only context in `<Visibility for="agents">` so the assistant and other AI tools see the most relevant information without cluttering your published pages.
+</Tip>
diff --git a/cli/index.mdx b/cli/index.mdx
@@ -36,6 +36,18 @@ Run `mint score` to evaluate how well agents can navigate a documentation site.
 ### Manage configuration
 Run `mint config` to set persistent defaults like your documentation subdomain and date ranges for analytics commands.
 
+<Tip>
+  Working on your docs locally with an AI coding tool? Install the Mintlify [skill](/ai/skillmd) and [MCP server](/ai/model-context-protocol) so your editor has the context it needs to write Mintlify-aware content.
+</Tip>
+
+<Prompt description="Install the Mintlify skill and MCP server for AI coding tools." actions={["copy", "cursor"]}>
+Install the Mintlify skill to get context on Mintlify project structure, components, and documentation best practices:
+
+npx skills add https://mintlify.com/docs
+
+Then add the Mintlify MCP server for access to documentation search. Follow the setup instructions at https://www.mintlify.com/docs/ai/model-context-protocol.md
+</Prompt>
+
 ## Next steps
 
 - [Install the CLI](/cli/install): Get the CLI installed and ready to use.