mintlify · yangleyland · Jun 25, 2026
diff --git a/ai/skillmd.mdx b/ai/skillmd.mdx
@@ -1,13 +1,13 @@
 ---
 title: "skill.md"
 description: "Make your documentation agent-ready with automatically generated skill.md files that describe your product's capabilities for AI agents."
 keywords: ["AI agents", "skills", "agent skills", "agents"]
 boost: 3
 ---

 Mintlify hosts a `skill.md` file at the root of your project that describes what AI agents can do with your product.

 The [skill.md specification](https://agentskills.io/specification) is a structured, machine-readable format that makes capabilities, required inputs, and constraints for products explicit so that agents can use them more reliably.

 Mintlify automatically generates a `skill.md` file for your project by analyzing your documentation with an agentic loop. This file stays up to date as you make updates to your documentation and requires no maintenance. You can optionally add a custom `skill.md` file to the root of your project that overrides the automatically generated one.

@@ -20,19 +20,19 @@
 </PreviewButton>

 <Tip>
  Both `llms.txt` and `skill.md` files help agents work with your documentation, but they serve different purposes.

  - `llms.txt` is a directory. It lists all your documentation pages with descriptions so agents know where to find information.
  - `skill.md` is a capability summary. It tells agents what they can accomplish with your product, what inputs they need, and what constraints apply.
 </Tip>

 ## Use `skill.md` files with agents

 <Note>
  If you use a [reverse proxy](/deploy/reverse-proxy), configure it to forward `/skill.md`, `/.well-known/skills/*`, and `/.well-known/agent-skills/*` paths to your Mintlify subdomain.
 </Note>

 When users connect to your MCP server, their agents can discover and use your `skill.md` files as [MCP resources](/ai/model-context-protocol#mcp-resources) without installing the skills separately.

 To add your skills to an agent's context manually, use the [skills CLI](https://www.npmjs.com/package/skills).

@@ -46,12 +46,12 @@
  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>

 ## `skill.md` structure

 Mintlify generates a `skill.md` file following the [agentskills.io specification](https://agentskills.io/specification). The generated file includes:

 - **Metadata**: Project name, description, and version.
 - **Capabilities**: What agents can accomplish with your product.
 - **Skills**: Specific actions organized by category.
 - **Workflows**: Step-by-step procedures for common tasks.
 - **Integration**: Supported tools and services.
@@ -105,7 +105,7 @@
  docs.json
 ```

 Mintlify resolves symlinks during deployment, so the skill files are discovered and served as if they were directly inside `.mintlify/skills/`. This works with both directory symlinks and individual skill symlinks.

 ### Frontmatter fields

@@ -134,7 +134,7 @@

 ## Skills discovery endpoints

 Mintlify hosts skills directories at `/.well-known/skills/` and `/.well-known/agent-skills/` that agents can use to discover and fetch your skill files programmatically.

 ### Agent-skills discovery (recommended)

@@ -211,7 +211,7 @@
 | `capabilities`        | Feature flags. Currently `{ streaming: false, pushNotifications: false }`.                                   |
 | `skills`              | The skills exposed at `/.well-known/agent-skills/`.                                                          |
 
-URLs in the card (`url`, `documentationUrl`, `provider.url`, and each skill URL) use your configured custom domain, so the published card always advertises the canonical domain instead of the `*.mintlify.app` subdomain.
+URLs in the card (`url`, `documentationUrl`, `provider.url`, and each skill URL) use your configured custom domain, so the published card always advertises the canonical domain instead of the `*.mintlify.site` subdomain.
 
 <Note>
   If you use a [reverse proxy](/deploy/reverse-proxy), configure it to forward `/.well-known/agent-card.json` to your Mintlify subdomain.

diff --git a/assistant/use.mdx b/assistant/use.mdx
@@ -75,8 +75,8 @@ Open the assistant from any page on your documentation site by adding the `?assi
 - `?assistant=<message>`: Open the assistant chat panel and submit `<message>` as the user's first message. URL-encode the value so spaces and special characters survive the request.
 
 ```text Examples
-https://yourdocs.mintlify.app/quickstart?assistant
-https://yourdocs.mintlify.app/quickstart?assistant=How%20do%20I%20get%20started%3F
+https://yourdocs.mintlify.site/quickstart?assistant
+https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started%3F
 ```
 
 ## Highlight text

diff --git a/customize/themes.mdx b/customize/themes.mdx
@@ -28,35 +28,35 @@
        </div>
      </div>
    </a>
  );
 };

 <div className="pt-10 pb-24 px-4 max-w-3xl mx-auto prose prose-gray">
  <label className="eyebrow h-5 text-primary dark:text-primary-light text-sm font-semibold">Core Concepts</label>
  <h1 className="mt-1 mb-2 text-2xl sm:text-3xl text-gray-900 tracking-tight dark:text-gray-200 font-semibold">Themes</h1>
  <label className="text-lg prose prose-gray dark:prose-invert">Customize the appearance of your documentation<br /><br />Configure [theme](/organize/settings-appearance#theme) in docs.json using one of the following themes.</label>

 <br />
 
 <div className="mt-10 grid grid-cols-1 sm:grid-cols-2 gap-8 not-prose">
 
-<ThemeCard title="Mint" value="mint" description="Classic documentation theme with time-tested layouts and familiar navigation." href="https://mint.mintlify.app" />
+<ThemeCard title="Mint" value="mint" description="Classic documentation theme with time-tested layouts and familiar navigation." href="https://mint.mintlify.site" />
 
-<ThemeCard title="Maple" value="maple" description="Modern, clean aesthetics perfect for AI and SaaS products." href="https://maple.mintlify.app" />
+<ThemeCard title="Maple" value="maple" description="Modern, clean aesthetics perfect for AI and SaaS products." href="https://maple.mintlify.site" />
 
-<ThemeCard title="Palm" value="palm" description="Sophisticated fintech theme with deep customization for enterprise documentation." href="https://palm.mintlify.app" />
+<ThemeCard title="Palm" value="palm" description="Sophisticated fintech theme with deep customization for enterprise documentation." href="https://palm.mintlify.site" />
 
-<ThemeCard title="Willow" value="willow" description="Stripped-back essentials for distraction-free documentation." href="https://willow.mintlify.app" />
+<ThemeCard title="Willow" value="willow" description="Stripped-back essentials for distraction-free documentation." href="https://willow.mintlify.site" />
 
-<ThemeCard title="Linden" value="linden" description="Retro terminal vibes with monospace fonts for that 80s hacker aesthetic." href="https://linden.mintlify.app" />
+<ThemeCard title="Linden" value="linden" description="Retro terminal vibes with monospace fonts for that 80s hacker aesthetic." href="https://linden.mintlify.site" />
 
-<ThemeCard title="Almond" value="almond" description="Card-based organization meets minimalist design for intuitive navigation." href="https://almond.mintlify.app" />
+<ThemeCard title="Almond" value="almond" description="Card-based organization meets minimalist design for intuitive navigation." href="https://almond.mintlify.site" />
 
-<ThemeCard title="Aspen" value="aspen" description="Modern documentation crafted for complex navigation and custom components." href="https://aspen.mintlify.app" />
+<ThemeCard title="Aspen" value="aspen" description="Modern documentation crafted for complex navigation and custom components." href="https://aspen.mintlify.site" />
 
-<ThemeCard title="Sequoia" value="sequoia" description="Minimal, elegant layouts designed for large-scale content-focused documentation." href="https://sequoia.mintlify.app" />
+<ThemeCard title="Sequoia" value="sequoia" description="Minimal, elegant layouts designed for large-scale content-focused documentation." href="https://sequoia.mintlify.site" />
 
-<ThemeCard title="Luma" value="luma" description="Clean, minimal design for polished documentation." href="https://luma.mintlify.app" />
+<ThemeCard title="Luma" value="luma" description="Clean, minimal design for polished documentation." href="https://luma.mintlify.site" />
 
 </div>
 

diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
@@ -12,9 +12,9 @@

 Authentication requires users to log in before accessing your content.
 
 You can configure full authentication for all pages or partial authentication where some pages are public and others are protected.
 
-Authentication is only available for sites hosted on a custom domain or Mintlify subdomain. For example, `docs.example.com` or `example.mintlify.app`. Authentication is **not supported** for sites with a [custom subpath](/deploy/docs-subpath). For example, `example.com/docs`.
+Authentication is only available for sites hosted on a custom domain or Mintlify subdomain. For example, `docs.example.com` or `example.mintlify.site`. Authentication is **not supported** for sites with a [custom subpath](/deploy/docs-subpath). For example, `example.com/docs`.
 
 ## Configure authentication
 
@@ -105,8 +105,8 @@
      * **Scopes** (optional): Permissions to request. Copy the **entire** scope string (for example, for a scope like `provider.users.docs`, copy the complete `provider.users.docs`). Use multiple scopes if you need different access levels.
      * **Additional authorization parameters** (optional): Additional query parameters to add to the initial authorization request.
      * **Token URL**: Your OAuth token exchange endpoint.
      * **Info API URL** (optional): Endpoint on your server that Mintlify calls to retrieve user info. Required for group-based access control. If omitted, the OAuth flow only verifies identity.
      * **Logout URL** (optional): The native logout URL for your OAuth provider. When users log out, Mintlify validates the logout redirect against this configured URL for security. The redirect only succeeds if it exactly matches the configured `logoutUrl`. If you do not configure a logout URL, users redirect to `/login`. Mintlify redirects users with a `GET` request and does not append query parameters, so include any parameters (for example, `returnTo`) directly in the URL.
      * **Redirect URL** (optional): The URL to redirect users to after authentication.
    6. Click **Save changes**.

@@ -138,7 +138,7 @@
 - **Scopes**: `['provider.users.docs']`
 - **Token URL**: `https://auth.foo.com/exchange`
 - **Info API URL**: `https://api.foo.com/docs/user-info`
 - **Logout URL**: `https://auth.foo.com/logout?returnTo=https%3A%2F%2Fdocs.foo.com`

 **Create a user info endpoint** at `api.foo.com/docs/user-info`, which requires an OAuth access token with the `provider.users.docs` scope, and returns:


diff --git a/deploy/cloudflare.mdx b/deploy/cloudflare.mdx
@@ -66,7 +66,7 @@ async function handleRequest(request) {
     // If the request is to the docs subpath
     if (/^\/docs/.test(urlObject.pathname)) {
       // Then Proxy to Mintlify
-      const DOCS_URL = "[SUBDOMAIN].mintlify.dev";
+      const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";
 
       let url = new URL(request.url);
@@ -149,7 +149,7 @@ If you use Webflow to host your main site and want to serve Mintlify docs at `/d
     // If the request is to the docs subpath
     if (/^\/docs/.test(urlObject.pathname)) {
       // Proxy to Mintlify
-      const DOCS_URL = "[SUBDOMAIN].mintlify.dev";
+      const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";
       let url = new URL(request.url);
       url.hostname = DOCS_URL;

diff --git a/deploy/csp-configuration.mdx b/deploy/csp-configuration.mdx
@@ -24,14 +24,14 @@
 | Domain | Purpose | CSP directive | Required |
 |:-------|:--------|:--------------|:-------|
 | `d4tuoctqmanu0.cloudfront.net` | KaTeX CSS, fonts | `style-src`, `font-src` | Required |
-| `*.mintlify.dev` | Documentation content | `connect-src`, `frame-src` | Required |
+| `*.mintlify.site` | Documentation content | `connect-src`, `frame-src` | Required |
 | `*.mintlify.com` | Dashboard, API, analytics proxy | `connect-src` | Required |
 | `leaves.mintlify.com` | Assistant API | `connect-src` | Required |
 | `d3gk2c5xim1je2.cloudfront.net` | Icons, images, logos | `img-src` | Required |
 | `d1ctpt7j8wusba.cloudfront.net` | Mint version and release files | `connect-src` | Required |
 | `mintcdn.com` | Images, favicons | `img-src`, `connect-src` | Required |
 | `*.mintcdn.com` | Images, favicons | `img-src`, `connect-src` | Required |
 | `cdn.jsdelivr.net` | Emoji assets for OG images | `script-src`, `img-src` | Required |
 | `mintlify.s3.us-west-1.amazonaws.com` | S3-hosted images | `img-src` | Required |
 | `hcaptcha.com` | hCaptcha CAPTCHA verification | `script-src`, `frame-src`, `style-src`, `connect-src`, `unsafe-eval`, `unsafe-inline` | Required |
 | `*.hcaptcha.com` | hCaptcha CAPTCHA verification | `script-src`, `frame-src`, `style-src`, `connect-src`, `unsafe-eval`, `unsafe-inline` | Required |
@@ -62,9 +62,9 @@
 style-src 'self' 'unsafe-inline' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com hcaptcha.com *.hcaptcha.com;
 font-src 'self' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com;
 img-src 'self' data: blob: d3gk2c5xim1je2.cloudfront.net mintcdn.com *.mintcdn.com cdn.jsdelivr.net mintlify.s3.us-west-1.amazonaws.com;
-connect-src 'self' *.mintlify.dev *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com
+connect-src 'self' *.mintlify.site *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com
 www.googletagmanager.com cdn.segment.com plausible.io us.posthog.com browser.sentry-cdn.com hcaptcha.com *.hcaptcha.com;
-frame-src 'self' *.mintlify.dev hcaptcha.com *.hcaptcha.com;
+frame-src 'self' *.mintlify.site hcaptcha.com *.hcaptcha.com;
 ```
 
 ## Common configurations by proxy type
@@ -82,7 +82,7 @@
   - **Header name**: `Content-Security-Policy`
   - **Header value**:
     ```text wrap
-    default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval' cdn.jsdelivr.net hcaptcha.com *.hcaptcha.com; style-src 'self' 'unsafe-inline' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com hcaptcha.com *.hcaptcha.com; font-src 'self' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com; img-src 'self' data: blob: d3gk2c5xim1je2.cloudfront.net mintcdn.com *.mintcdn.com cdn.jsdelivr.net mintlify.s3.us-west-1.amazonaws.com; connect-src 'self' *.mintlify.dev *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com hcaptcha.com *.hcaptcha.com; frame-src 'self' *.mintlify.dev hcaptcha.com *.hcaptcha.com;
+    default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval' cdn.jsdelivr.net hcaptcha.com *.hcaptcha.com; style-src 'self' 'unsafe-inline' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com hcaptcha.com *.hcaptcha.com; font-src 'self' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com; img-src 'self' data: blob: d3gk2c5xim1je2.cloudfront.net mintcdn.com *.mintcdn.com cdn.jsdelivr.net mintlify.s3.us-west-1.amazonaws.com; connect-src 'self' *.mintlify.site *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com hcaptcha.com *.hcaptcha.com; frame-src 'self' *.mintlify.site hcaptcha.com *.hcaptcha.com;
     ```
 4. Deploy your rule.
 
@@ -97,7 +97,7 @@
     "Config": {
     "SecurityHeadersConfig": {
         "ContentSecurityPolicy": {
-        "ContentSecurityPolicy": "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval' cdn.jsdelivr.net hcaptcha.com *.hcaptcha.com; style-src 'self' 'unsafe-inline' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com hcaptcha.com *.hcaptcha.com; font-src 'self' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com; img-src 'self' data: blob: d3gk2c5xim1je2.cloudfront.net mintcdn.com *.mintcdn.com cdn.jsdelivr.net mintlify.s3.us-west-1.amazonaws.com; connect-src 'self' *.mintlify.dev *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com hcaptcha.com *.hcaptcha.com; frame-src 'self' *.mintlify.dev hcaptcha.com *.hcaptcha.com;",
+        "ContentSecurityPolicy": "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval' cdn.jsdelivr.net hcaptcha.com *.hcaptcha.com; style-src 'self' 'unsafe-inline' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com hcaptcha.com *.hcaptcha.com; font-src 'self' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com; img-src 'self' data: blob: d3gk2c5xim1je2.cloudfront.net mintcdn.com *.mintcdn.com cdn.jsdelivr.net mintlify.s3.us-west-1.amazonaws.com; connect-src 'self' *.mintlify.site *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com hcaptcha.com *.hcaptcha.com; frame-src 'self' *.mintlify.site hcaptcha.com *.hcaptcha.com;",
         "Override": true
         }
       }
@@ -118,7 +118,7 @@
     "headers": [
         {
         "key": "Content-Security-Policy",
-        "value": "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval' cdn.jsdelivr.net hcaptcha.com *.hcaptcha.com; style-src 'self' 'unsafe-inline' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com hcaptcha.com *.hcaptcha.com; font-src 'self' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com; img-src 'self' data: blob: d3gk2c5xim1je2.cloudfront.net mintcdn.com *.mintcdn.com cdn.jsdelivr.net mintlify.s3.us-west-1.amazonaws.com; connect-src 'self' *.mintlify.dev *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com hcaptcha.com *.hcaptcha.com; frame-src 'self' *.mintlify.dev hcaptcha.com *.hcaptcha.com;"
+        "value": "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval' cdn.jsdelivr.net hcaptcha.com *.hcaptcha.com; style-src 'self' 'unsafe-inline' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com hcaptcha.com *.hcaptcha.com; font-src 'self' d4tuoctqmanu0.cloudfront.net fonts.googleapis.com; img-src 'self' data: blob: d3gk2c5xim1je2.cloudfront.net mintcdn.com *.mintcdn.com cdn.jsdelivr.net mintlify.s3.us-west-1.amazonaws.com; connect-src 'self' *.mintlify.site *.mintlify.com d1ctpt7j8wusba.cloudfront.net mintcdn.com *.mintcdn.com hcaptcha.com *.hcaptcha.com; frame-src 'self' *.mintlify.site hcaptcha.com *.hcaptcha.com;"
         }
       ]
     }