Agent skill sync with docs: className, MDX code, CLI flags

agent-context/context/skills/mintlify/reference/cli.md

@@ -2,23 +2,23 @@
 
 Condensed reference for common `mint` CLI commands and their key flags.
 
-Install with `npm i -g mint`.
+Install with `npm i -g mint`. The npm package is `mint`; do not install the legacy `mintlify` package.
 
 ## Global flags
 
 Available on all commands.
 
 | Flag | Description |
 |------|-------------|
-| `--telemetry`, `-t` | Enable or disable anonymous usage telemetry. |
+| `--telemetry`, `-t` | Enable or disable usage telemetry. |
 | `--help`, `-h` | Display help for the command. |
 | `--version`, `-v` | Display the CLI version. Alias for `mint version`. |
 
 ## Local development
 
-- `mint dev` — Start local preview at localhost:3000. `--port` sets the port. `--no-open` skips browser launch. `--groups <names>` mocks user groups. `--disable-openapi` skips OpenAPI processing. `--disable-prefetch` disables navigation prefetching. `--local-schema` allows locally-hosted OpenAPI files over HTTP.
-- `mint validate` — Strict build validation; exits non-zero on warnings or errors. `--groups <names>` mocks user groups. `--disable-openapi` skips OpenAPI processing. `--local-schema` allows local OpenAPI files.
-- `mint export` — Export a static site zip for air-gapped deployment. `--output <file>` sets the output path (default: `export.zip`). `--groups <names>` includes restricted pages. `--disable-openapi` skips OpenAPI processing.
+- `mint dev` — Start local preview at localhost:3000. `--port` sets the port. `--no-open` skips browser launch. `--groups` mocks user groups (space-separated, e.g. `--groups admin user`). `--disable-openapi` skips OpenAPI processing. `--disable-prefetch` disables navigation prefetching. `--local-schema` allows locally-hosted OpenAPI files over HTTP.
+- `mint validate` — Strict build validation; exits non-zero on warnings or errors. `--groups` mocks user groups (space-separated). `--disable-openapi` skips OpenAPI processing. `--local-schema` allows local OpenAPI files.
+- `mint export` — Export a static site zip for air-gapped deployment. `--output <file>` sets the output path (default: `export.zip`). `--groups` includes restricted pages (space-separated). `--disable-openapi` skips OpenAPI processing.
 
 ## Content quality
 
@@ -93,7 +93,7 @@ All `mint automations` subcommands share these flags: `--subdomain`, `--format`
 
 ## Telemetry
 
-The CLI collects anonymous usage telemetry by default. Opt out with `--telemetry false` or by setting either environment variable:
+The CLI collects usage telemetry by default (command name, CLI version, OS, architecture). When you are logged in, telemetry events also include your account email; logged-out usage stays anonymous. Opt out with `--telemetry false` or by setting either environment variable:
 
 | Variable | Value | Description |
 |----------|-------|-------------|

agent-context/context/skills/mintlify/reference/components.md

@@ -2,6 +2,12 @@
 
 Full syntax and props for all Mintlify components.
 
+## Styling with className
+
+All built-in components accept a `className` prop (string) except Banner, MDX, and Visibility. Mintlify merges your classes with the component's own styles. Use Tailwind CSS v3 classes, including arbitrary values such as `w-[350px]`, or class names defined in a custom CSS file. Write class names out in full. Mintlify generates CSS only for class names found in the page source, so runtime-assembled names like `` bg-${color}-500 `` produce no CSS. On `<Tab>`, `className` styles the tab's content panel, not its label in the tab bar.
+
+Component `title` props (for example on Accordion, Step, and Tab) support inline Markdown formatting such as `**bold**`, `_italic_`, and `` `code` ``.
+
 ## Callouts
 
 Styled alert boxes for important information.
@@ -424,6 +430,7 @@ Notes:
 - Block form at the top level of a page: leave a blank line after the opening tag so content parses as block-level Markdown.
 - Inside expressions, `<MDX>` strips the common leading indentation from its content.
 - Headings inside `<MDX>` appear in the page's table of contents, including headings in branches that never render (such as the inactive side of a conditional).
+- Code fences and inline code inside `<MDX>` compile like code at the page root. Raw `<`, `>`, `{`, and `}` need no escaping. Character references decode to their characters (`&lt;` renders as `<`; write `&amp;lt;` for a literal `&lt;`).
 - Limits: nest `<MDX>` up to 8 levels deep; a page can expand up to 500 `<MDX>` fragments inside expressions. Exceeding either limit fails the build.
 
 ## Panel

agent-context/context/skills/mintlify/reference/configuration.md

@@ -587,7 +587,7 @@ Add `.css` files to your repository. Class names become available in all MDX fil
 }
 ```
 
-Built-in Tailwind CSS v3 classes are available. Arbitrary values (e.g., `w-[350px]`) are not supported — use inline `style` instead.
+Built-in Tailwind CSS v3 classes are available, including arbitrary values (e.g., `w-[350px]`) and variants (`sm:`, `hover:`, `dark:`). All built-in components except Banner, MDX, and Visibility accept a `className` prop. Write class names out in full: Mintlify generates CSS only for class names found in the page source, so runtime-assembled names produce no CSS. Avoid the inline `style` prop; it can cause layout shift on page load.
 
 ### JavaScript