diff --git a/agent/index.mdx b/agent/index.mdx
index 9a027e2cc..8bebe5460 100644
--- 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.
+
+
+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
+
+
## Next steps
diff --git a/ai-native.mdx b/ai-native.mdx
index ef4cbd976..c1515ae23 100644
--- 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.
+
+ 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
+
+ npx skills add https://your-docs-domain.com
+
+ ```
+
+
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
index 85e4e01d5..f888e98c8 100644
--- 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.
+
+ 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.
+
+
## 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
index b52763dcc..6039b6fc3 100644
--- a/assistant/index.mdx
+++ b/assistant/index.mdx
@@ -59,3 +59,7 @@ Structure your documentation to help the assistant provide accurate, relevant an
- Cross-reference related topics.
- Add [hidden pages](/organize/hidden-pages) with additional context that users don't need, but the assistant can reference.
+
+
+ Use the [`Visibility`](/components/visibility) component to tailor content for human readers and AI tools on the same page. Wrap UI-oriented content in `` and API-oriented or agent-only context in `` so the assistant and other AI tools see the most relevant information without cluttering your published pages.
+
diff --git a/cli/index.mdx b/cli/index.mdx
index c68f97b1a..ea24c1bc5 100644
--- 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.
+
+ 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.
+
+
+
+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
+
+
## Next steps
- [Install the CLI](/cli/install): Get the CLI installed and ready to use.