diff --git a/agent-context/context/skills/mintlify/SKILL.md b/agent-context/context/skills/mintlify/SKILL.md
index 42ad61d60..0ceb379d2 100644
--- a/agent-context/context/skills/mintlify/SKILL.md
+++ b/agent-context/context/skills/mintlify/SKILL.md
@@ -218,7 +218,7 @@ Use `<Columns>` to arrange cards (or other content) in a grid. `cols` accepts 1-
 
 ## CLI commands
 
-Install with `npm i -g mint`. Key commands: `mint dev` (local preview), `mint validate`, `mint broken-links`, `mint a11y`, `mint score`, `mint automations`, `mint new`, `mint signup`, `mint index` (install the Mintlify Index MCP server in supported coding agents). Read `reference/cli.md` for full flags and subcommands.
+Install with `npm i -g mint`. Key commands: `mint dev` (local preview), `mint validate`, `mint broken-links`, `mint a11y`, `mint test` (generate tests from code samples), `mint score`, `mint automations`, `mint new`, `mint signup`, `mint index` (install the Mintlify Index MCP server in supported coding agents). Read `reference/cli.md` for full flags and subcommands.
 
 ## Writing standards
 
diff --git a/agent-context/context/skills/mintlify/reference/api-docs.md b/agent-context/context/skills/mintlify/reference/api-docs.md
index 2c93ee355..0ae0ea10d 100644
--- a/agent-context/context/skills/mintlify/reference/api-docs.md
+++ b/agent-context/context/skills/mintlify/reference/api-docs.md
@@ -55,7 +55,7 @@ For OpenAPI 3.1 specs, describe a file upload field as a string schema with a bi
 
 - `x-hidden`: Creates page but hides from navigation.
 - `x-excluded`: Completely excludes endpoint from docs.
-- `x-codeSamples`: Custom code examples per endpoint.
+- `x-codeSamples`: Custom code examples per endpoint. Write these by hand. If you generate SDKs with Speakeasy, you can instead point the `openapi` field in `docs.json` at the Speakeasy combined spec URL (the `*-with-code-samples` API Registry entry) to pull autogenerated samples.
 - `x-mint.playground.expand`: Set to `false` on an operation to collapse nested object fields in the playground by default. Request sections (Authorization, Headers, Query, Path, Body) and the top-level body object stay expanded. Defaults to expanded when unset.
 
 ```yaml
diff --git a/agent-context/context/skills/mintlify/reference/cli.md b/agent-context/context/skills/mintlify/reference/cli.md
index 10064fe0b..0b6464744 100644
--- a/agent-context/context/skills/mintlify/reference/cli.md
+++ b/agent-context/context/skills/mintlify/reference/cli.md
@@ -26,6 +26,7 @@ Available on all commands.
 - `mint a11y` — Accessibility checks (alt text, color contrast). `--skip-contrast` or `--skip-alt-text` to narrow scope.
 - `mint score [url]` — Score a docs site's AI/agent readiness. Checks llms.txt, MCP discoverability, robots.txt, sitemap, structured data, response latency, and more. Requires `mint login`. Defaults to your configured subdomain. `--format` accepts `table` (default), `plain`, or `json`.
 - `mint format` — Format every `.mdx` file in the current directory and its subdirectories in place. Respects `.gitignore` and Mintlify ignore rules. Commit or stash changes first so you can review the rewrite.
+- `mint test` — Scan content for code blocks and generate unit tests that validate them. Interactive; only pages in the `docs.json` navigation appear for selection. Writes generated test projects to `tests/mint-test/<run-id>/` (one directory per agent and page) and run reports to `.mintlify/test/` (including `runs/<run-id>.json`). Add both paths to `.gitignore` to avoid committing test artifacts.
 
 ## Authentication