diff --git a/agent-context/context/skills/mintlify/SKILL.md b/agent-context/context/skills/mintlify/SKILL.md
index 2b5b85d3b..275c06099 100644
--- a/agent-context/context/skills/mintlify/SKILL.md
+++ b/agent-context/context/skills/mintlify/SKILL.md
@@ -123,7 +123,7 @@ keywords: ["relevant", "search", "terms"]
 | `title` | string | Page title in navigation and browser tabs. Auto-generated from the path if omitted. |
 | `description` | string | Brief description for SEO. Displays under the title. |
 | `sidebarTitle` | string | Short title for sidebar navigation. |
-| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a URL or file path. |
+| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a single emoji, a URL, or a file path. |
 | `tag` | string | Label next to page title in sidebar (e.g., "NEW"). |
 | `hidden` | boolean | Remove from sidebar. Page still accessible by URL. |
 | `mode` | string | Page layout: `default`, `wide`, `custom`, `frame`, `center`. |
diff --git a/agent-context/context/skills/mintlify/reference/components.md b/agent-context/context/skills/mintlify/reference/components.md
index 738467a4b..4fb17dc24 100644
--- a/agent-context/context/skills/mintlify/reference/components.md
+++ b/agent-context/context/skills/mintlify/reference/components.md
@@ -323,10 +323,10 @@ Text with <Icon icon="check" iconType="solid" /> inline icon.
 ```
 
 Props:
-- `icon` (string, required): Icon name, URL, or file path.
+- `icon` (string, required): Font Awesome, Lucide, or Tabler icon name, a single emoji, a URL, or a file path.
 - `iconType` (string): Font Awesome style.
 - `size` (number): Pixel size.
-- `color` (string): Hex color.
+- `color` (string): Hex color. Not applied to emoji icons.
 
 ## Tooltips
 
diff --git a/agent-context/context/skills/mintlify/reference/configuration.md b/agent-context/context/skills/mintlify/reference/configuration.md
index b8ccc7b80..06ef0a2b4 100644
--- a/agent-context/context/skills/mintlify/reference/configuration.md
+++ b/agent-context/context/skills/mintlify/reference/configuration.md
@@ -57,7 +57,7 @@ The SKILL.md file lists common frontmatter fields. Here is the complete set. All
 | `title` | string | Page title in navigation and browser tabs. Auto-generated from the path if omitted. |
 | `description` | string | Brief description for SEO. Displays under the title. |
 | `sidebarTitle` | string | Short title for sidebar navigation. |
-| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a URL or file path. |
+| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a single emoji, a URL, or a file path. |
 | `iconType` | string | Font Awesome icon style: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`. |
 | `tag` | string | Label next to page title in sidebar (e.g., "NEW"). |
 | `hidden` | boolean | Remove from sidebar. Page still accessible by URL. Also excludes the page from search, sitemaps, external indexing, AI context, and `llms.txt`. Remove the field (or set `false`) to make a page visible again. |
@@ -180,7 +180,7 @@ Single file or light/dark variants:
 }
 ```
 
-Options: `"fontawesome"` (default), `"lucide"`, or `"tabler"`. You can only use one library per project. Individual icons can still use URLs or file paths regardless of this setting.
+Options: `"fontawesome"` (default), `"lucide"`, or `"tabler"`. You can only use one library per project. Individual icons can still use a single emoji, a URL, or a file path regardless of this setting.
 
 ## Fonts
 
@@ -547,6 +547,8 @@ import { Counter } from "/snippets/counter.jsx";
 
 JSX components can live in any directory, not just `/snippets/`. Nested imports between snippet files are not supported.
 
+MDX expressions (imported variables like `{myName}` and inline expressions like `{1 + 1}`) are evaluated client-side. Their values are absent from a page's initial HTML and from offline exports. Crawlers, LLMs, and other tools that do not run JavaScript do not see them. Write values as plain text when they must be visible in those situations.
+
 ## Hidden pages
 
 Set `hidden: true` in frontmatter to remove from sidebar. Page remains accessible by URL.