mintlify · ethanpalm · Jul 21, 2026 · Jul 17, 2026 · Jul 21, 2026
diff --git a/ai/skillmd.mdx b/ai/skillmd.mdx
@@ -42,6 +42,19 @@ npx skills add https://your-docs-domain.com
 
 This adds your product's capabilities to the agent's context so it can take actions on behalf of users.
 
+{/* vale off */}
+
+<Prompt description="Install a product's skill.md files into your agent." actions={["copy", "cursor"]}>
+Install the `skill.md` files from a Mintlify-hosted documentation site into my agent context so you know what this product can do.
+
+1. Ask me for the documentation site URL if I haven't provided one, then run `npx skills add <url>` with that URL.
+2. Print the list of skills that were installed, including each skill's name and description.
+3. Summarize the key capabilities in one paragraph so I know what you can now help me accomplish with this product.
+4. If any skill declares required inputs or constraints in its frontmatter, call them out before I ask you to use it.
+</Prompt>
+
+{/* vale on */}
+
 <Tip>
   Teach your users how to use `skill.md` files with agents so that they have better results using your product with their AI tools.
 </Tip>

diff --git a/cli/install.mdx b/cli/install.mdx
@@ -20,6 +20,23 @@ keywords: ["CLI", "npm", "install", "Node.js", "pnpm", "mint"]
   ```
 </CodeGroup>
 
+<Tip>
+  Using an AI coding tool? Copy the following prompt to have your agent install the CLI and verify it works.
+</Tip>
+
+{/* vale off */}
+
+<Prompt description="Install the Mintlify CLI globally and verify the installation." actions={["copy", "cursor"]}>
+Install the Mintlify CLI globally so I can preview my documentation locally.
+
+1. Confirm Node.js v20.17.0 or newer is installed by running `node --version`. If it is missing or older, tell me before continuing.
+2. Install the CLI with `npm i -g mint` (or `pnpm add -g mint` if I use pnpm).
+3. Verify the install by running `mint --version` and share the output.
+4. If the install fails with a permissions error, suggest re-running with `sudo` and explain the tradeoff.
+</Prompt>
+
+{/* vale on */}
+
 ## Create a new project
 
 To create a new documentation project from the Mintlify starter template, run the following command:
@@ -28,6 +45,19 @@ To create a new documentation project from the Mintlify starter template, run th
 mint new [directory]
 ```
 
+{/* vale off */}
+
+<Prompt description="Scaffold a new Mintlify project." actions={["copy", "cursor"]}>
+Create a new Mintlify project in the current workspace.
+
+1. Ask me for a project name and preferred theme (or template) if I haven't already told you.
+2. Run `mint new <directory> --name <name> --theme <theme>` non-interactively, substituting the values I gave you. If I chose a template instead, run `mint new <directory> --template <template-name>`.
+3. After the command finishes, list the generated files and point out `docs.json` as the main configuration entry point.
+4. Run `mint dev` from the new directory and share the local preview URL.
+</Prompt>
+
+{/* vale on */}
+
 If you do not specify a directory, the CLI prompts you to create a new subdirectory or overwrite the current directory.
 
 <Warning>

diff --git a/guides/claude-code.mdx b/guides/claude-code.mdx
@@ -5,6 +5,8 @@ description: "Configure Claude Code with CLAUDE.md project instructions to write
 keywords: ["Claude Code", "CLAUDE.md", "AI documentation", "Anthropic", "Claude"]
 ---
 
+import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";
+
 Claude Code is an agentic command line tool that can help you maintain your documentation. It can write new content, review existing pages, and keep docs up to date.
 
 You can train Claude Code to understand your documentation standards and workflows by adding a `CLAUDE.md` file to your project and refining it over time.
@@ -23,6 +25,12 @@ You can train Claude Code to understand your documentation standards and workflo
 3. (Optional) Add the `CLAUDE.md` file below to your project.
 4. Run `claude` to start.
 
+<Tip>
+  Once Claude Code is running, paste the following prompt to load the Mintlify skill, [search MCP](/ai/model-context-protocol), and [admin MCP](/ai/mintlify-mcp) into the session so Claude has full context on Mintlify components and your site's content.
+</Tip>
+
+<SkillMcpPrompt />
+
 ## Template for CLAUDE.md
 
 Save a `CLAUDE.md` file at the root of your docs directory to help Claude Code understand your project. This file trains Claude Code on your documentation standards, preferences, and workflows. See [Manage Claude's memory](https://docs.anthropic.com/en/docs/claude-code/memory) in the Anthropic docs for more information.

diff --git a/guides/codex.mdx b/guides/codex.mdx
@@ -5,6 +5,8 @@ description: "Configure OpenAI Codex CLI with project instructions and MCP to wr
 keywords: ["Codex", "OpenAI Codex", "AGENTS.md", "AI documentation", "Codex CLI"]
 ---
 
+import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";
+
 Use OpenAI's Codex CLI to write and maintain Mintlify documentation from the terminal. Project instructions in `AGENTS.md` give Codex persistent context about your documentation standards, components, and style guide.
 
 ## Getting started
@@ -23,6 +25,12 @@ Use OpenAI's Codex CLI to write and maintain Mintlify documentation from the ter
 
 See the [Codex CLI documentation](https://developers.openai.com/codex/cli) for installation alternatives and authentication options.
 
+<Tip>
+  Once Codex is running, paste the following prompt to load the Mintlify [skill](/ai/skillmd), [search MCP](/ai/model-context-protocol), and [admin MCP](/ai/mintlify-mcp) into the session so Codex has full context on Mintlify components and your site's content.
+</Tip>
+
+<SkillMcpPrompt />
+
 ## Use Codex with Mintlify
 
 Codex reads `AGENTS.md` files from your repository to understand project-specific rules and conventions before it starts working. You can place an `AGENTS.md` at the root of your docs repo to give Codex context about Mintlify components, your writing standards, and how you structure your documentation.