Agent skill sync with docs: emoji icons and MDX client-side eval

[mintlify]

Summary

Sync the canonical Mintlify agent skill with two authoritative documentation changes: emoji as a supported icon option, and a new note that MDX expressions are evaluated client-side.

Changes

• SKILL.md, reference/configuration.md: frontmatter icon field now lists emoji alongside Lucide/Font Awesome/Tabler/URL/file path.
• reference/configuration.md Icons section: same emoji option added to the per-icon override note under icons.library.
• reference/components.md: <Icon> icon prop lists library names, emoji, URL, file path; color prop notes it does not apply to emoji icons.
• reference/configuration.md Reusable snippets: new paragraph explaining that MDX expressions (imported variables, inline {...}) are evaluated client-side and absent from initial HTML and offline exports.

Context

Upstream authoritative changes in the review window (2026-09-11 → 2026-09-12):

• Update from code changes: note emoji as icon option #7337 components/icons.mdx, components/tabs.mdx, components/view.mdx, organize/pages.mdx, organize/settings-reference.mdx, snippets/icons-*.mdx — added emoji as an icon option and noted color does not apply to emoji.
• Document client-side evaluation of MDX expressions #7334 create/reusable-snippets.mdx — added the client-side MDX expression evaluation note.

Other commits in the window were skipped as they did not change skill facts: BYOK credit copy (#7335), changelog entry (#7339), mint format guidance-only Tip (#7234), external MCP help-center article (#7343, no new fields/endpoints), reverse-proxy prose (#7350), and a prior in-skill terminology sync (#7340).

Validation

npm test, npm run check, and npm run build inside agent-context/ could not run in this environment because node_modules (including ajv) is not installed and package installation is disabled in the sandbox. git diff --check passed and the diff was inspected — only intended lines changed. The existing sync workflow will distribute the canonical skill to Codex, Cursor, and Claude plugin repos after merge.

---

Note

Low Risk
Documentation-only changes to agent skill reference files; no runtime code, auth, or data handling.

Overview
Updates the canonical Mintlify agent skill to match upstream docs: emoji is now documented as a valid icon value (frontmatter, docs.json icons overrides, and the <Icon> component), and the <Icon> color prop is noted as not applying to emoji.

Also adds guidance in the reusable snippets section that MDX expressions (imported variables and inline {...}) run client-side, so their output is missing from initial HTML, offline exports, and non-JS consumers—authors should use plain text when crawlers or LLMs must see the value.

^{Reviewed by Cursor Bugbot for commit 1d7b345. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
mintlify	🟢 Ready	View Preview	Sep 12, 2026, 4:10 PM