From 8e9cecf89188f256970faa138870b32fe44e3fe5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 23 Sep 2026 16:08:18 +0000 Subject: [PATCH 1/3] docs: remove mint automations from Mintlify skill CLI reference --- agent-context/context/skills/mintlify/SKILL.md | 4 ++-- agent-context/context/skills/mintlify/reference/cli.md | 8 -------- 2 files changed, 2 insertions(+), 10 deletions(-) diff --git a/agent-context/context/skills/mintlify/SKILL.md b/agent-context/context/skills/mintlify/SKILL.md index 9488e69b13..1d551dab00 100644 --- a/agent-context/context/skills/mintlify/SKILL.md +++ b/agent-context/context/skills/mintlify/SKILL.md @@ -17,7 +17,7 @@ Read these files **only when your task requires them**. They are in the `referen | `reference/configuration.md` | Changing docs.json settings (theme, colors, logo, fonts, appearance, navbar, footer, banner, redirects, SEO, integrations, API config). Also covers snippets, hidden pages, .mintignore, custom CSS/JS, and the complete frontmatter fields table. | | `reference/navigation.md` | Modifying site navigation structure (groups, tabs, anchors, dropdowns, products, versions, languages, OpenAPI, and SDK references in nav). | | `reference/api-docs.md` | Setting up API documentation (OpenAPI, AsyncAPI, MDX manual API pages, extensions, playground config). | -| `reference/cli.md` | Running common CLI commands (dev, validate, add-domain, automations, analytics, score, broken-links, a11y, format, and config) and their key flags. | +| `reference/cli.md` | Running common CLI commands (dev, validate, add-domain, analytics, score, broken-links, a11y, format, and config) and their key flags. | | `reference/product-context.md` | Before substantial content work (new site, broad restructure, first-time section setup) — check for and maintain `.mintlify/product-brief.md`. | ## MCP servers @@ -220,7 +220,7 @@ Use `` 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 test` (generate tests for code blocks), `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 for code blocks), `mint score`, `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/cli.md b/agent-context/context/skills/mintlify/reference/cli.md index 2e321071d1..17e05a4cb4 100644 --- a/agent-context/context/skills/mintlify/reference/cli.md +++ b/agent-context/context/skills/mintlify/reference/cli.md @@ -78,14 +78,6 @@ Query documentation analytics from the terminal. Requires `mint login`. All `min | Windsurf | `~/.codeium/windsurf/mcp_config.json` | Global only | | Zed | User `settings.json` | `.zed/settings.json` | -## Automations - -All `mint automations` subcommands share these flags: `--subdomain`, `--format` (table/json; default: table). `mint workflow` and `mint workflows` continue to work as aliases. - -- `mint automations create` — Create an automation. Requires exactly one trigger: `--cron ` for scheduled or `--push-repo ` (repeatable) for push-triggered. Key flags: `--name`, `--type` (one of `changelog`, `source-code-agent`, `translations`, `writing-style`, `typo-check`, `broken-link-detection`, `seo-metadata-audit`, `assistant-docs-updates`, `contextual-feedback-docs-updates`; omit for custom), `--prompt`, `--context-repo` (repeatable, up to 10), `--automerge`, `--file ` (JSON/YAML file overrides inline flags). -- `mint automations list` — List automations for the current deployment. -- `mint automations delete ` — Delete an automation by ID. Use `mint automations list` to get the ID. - ## Maintenance - `mint update` — Update the CLI to the latest version. From 7370e37361710bfb3579a7b12c914ec39ceb5cab Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 23 Sep 2026 10:43:53 -0700 Subject: [PATCH 2/3] test: assert skill no longer teaches mint automations The skill dropped mint automations to match #7458, but the build test still required the phrase. Move it to the doesNotMatch guard instead. Co-Authored-By: Claude Opus 5.5 (1M context) --- agent-context/test/build.test.mjs | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/agent-context/test/build.test.mjs b/agent-context/test/build.test.mjs index 9ab41c06f7..40de0b8403 100644 --- a/agent-context/test/build.test.mjs +++ b/agent-context/test/build.test.mjs @@ -52,8 +52,7 @@ test('builds all client variants from one canonical skill', async () => { assert.match(skill, /### Mintlify Search/); assert.match(skill, /### Mintlify Admin/); assert.match(skill, /Complete authentication in the browser when prompted/); - assert.match(skill, /mint automations/); - assert.doesNotMatch(skill, /mint analytics|mint workflow|\{\{/); + assert.doesNotMatch(skill, /mint analytics|mint automations|mint workflow|\{\{/); } assert.deepEqual(codexMcp.mcp_servers, cursorMcp.mcpServers); assert.deepEqual(claudeMcp.mcpServers, cursorMcp.mcpServers); From 9e959f71b2562272269e97c7f37bbe74acbb9af5 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 23 Sep 2026 10:55:43 -0700 Subject: [PATCH 3/3] agent-context: drop retired-command blocklist, restore mint analytics The build and test hardcoded a list of retired CLI commands. mint analytics was restored in the docs, but the blocklist kept it out of SKILL.md's CLI quick reference. Commands get removed and restored, so a blocklist goes stale; the skill content itself is the source of truth. Co-Authored-By: Claude Opus 5.5 (1M context) --- agent-context/README.md | 2 +- agent-context/context/skills/mintlify/SKILL.md | 2 +- agent-context/scripts/lib.mjs | 3 --- agent-context/test/build.test.mjs | 2 +- 4 files changed, 3 insertions(+), 6 deletions(-) diff --git a/agent-context/README.md b/agent-context/README.md index ea485dcf91..b5105ad23a 100644 --- a/agent-context/README.md +++ b/agent-context/README.md @@ -63,4 +63,4 @@ Every qualifying push to `main` validates the source and opens or updates the `a Edit shared knowledge and MCP definitions in `context/`, not in generated plugin copies. Put a value in `targets/` only when a client requires a different packaging format. -The build rejects retired CLI commands. Tests verify that the skill, detailed references, and MCP definitions remain semantically identical across targets. +Tests verify that the skill, detailed references, and MCP definitions remain semantically identical across targets. diff --git a/agent-context/context/skills/mintlify/SKILL.md b/agent-context/context/skills/mintlify/SKILL.md index 1d551dab00..9b8b0a5dd1 100644 --- a/agent-context/context/skills/mintlify/SKILL.md +++ b/agent-context/context/skills/mintlify/SKILL.md @@ -220,7 +220,7 @@ Use `` 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 test` (generate tests for code blocks), `mint score`, `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 for code blocks), `mint score`, `mint analytics` (traffic, search, feedback, and assistant conversations; Pro and Enterprise plans), `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/scripts/lib.mjs b/agent-context/scripts/lib.mjs index 01ce03ac58..5fd3bafcb5 100644 --- a/agent-context/scripts/lib.mjs +++ b/agent-context/scripts/lib.mjs @@ -126,9 +126,6 @@ function validateSkill(skill, target) { if (!/^name: mintlify$/m.test(skill) || !/^description: .+$/m.test(skill)) { throw new Error(`${target.id}: SKILL.md requires name and description fields`); } - if (/mint analytics/.test(skill)) { - throw new Error(`${target.id}: SKILL.md contains retired CLI commands`); - } } export async function buildTarget(target, outputRoot) { diff --git a/agent-context/test/build.test.mjs b/agent-context/test/build.test.mjs index 40de0b8403..42fa44135a 100644 --- a/agent-context/test/build.test.mjs +++ b/agent-context/test/build.test.mjs @@ -52,7 +52,7 @@ test('builds all client variants from one canonical skill', async () => { assert.match(skill, /### Mintlify Search/); assert.match(skill, /### Mintlify Admin/); assert.match(skill, /Complete authentication in the browser when prompted/); - assert.doesNotMatch(skill, /mint analytics|mint automations|mint workflow|\{\{/); + assert.doesNotMatch(skill, /\{\{/); } assert.deepEqual(codexMcp.mcp_servers, cursorMcp.mcpServers); assert.deepEqual(claudeMcp.mcpServers, cursorMcp.mcpServers);