Agent skill sync with docs: document mint index command

[mintlify]

Summary

Sync the canonical Mintlify agent skill with the newly documented mint index command.

Changes

• agent-context/context/skills/mintlify/reference/cli.md — Added an "MCP setup" section describing mint index, its client flags (--claude, --cursor, --vscode, --codex, --opencode, --windsurf, --zed), --project, --yes, the mintlify-index server it installs, the generated usage rule (skipped for Zed), Windsurf's global-only MCP config caveat, rerun behavior, and the standard per-client configuration paths.
• agent-context/context/skills/mintlify/SKILL.md — Added mint index to the quick CLI command list.

Context

Authoritative documentation changes in the review window (2026-08-06T16:00:00Z – 2026-08-07T16:06:33Z):

• cli/commands.mdx, cli/index.mdx (PR Update from code changes: document mint index command #6884, commit 7c7c1116) — Documented the new mint index command. This is the only change that affects skill-taught facts.

Other in-scope changes were reviewed and intentionally not synced:

• deploy/authentication-setup.mdx (PR Update from code changes: document OAuth group claims #6887) — OAuth group claim configuration (groupsClaim, groupsDelimiter, source) is dashboard-configured behavior; the skill does not teach OAuth setup facts.
• IA refresh (PRs IA refresh #6902, Fix broken links: correct create/changelogs nav path #6903, Fix grammar & typos: comma splice in concepts overview #6904, Translate content: IA refresh (concepts, glossary, nav) to es/fr/zh #6906) — docs.json navigation restructure plus new reference/concepts.mdx and reference/glossary.mdx pages and their translations. No component syntax, docs.json schema, CLI, or workflow facts changed.
• Translation-only, comma-splice, and nav-path fixes were ignored per the workflow spec.

Validation

Run from agent-context/:

• npm test → passes (2/2)
• npm run check → "All generated targets are valid and shared references are identical."
• npm run build → succeeds
• git diff --check → clean

The existing agent-context sync workflow will distribute the canonical skill to the Codex, Cursor, and Claude plugin repositories after merge.

---

Note

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

Overview
Updates the canonical Mintlify agent skill so agents know about the new mint index CLI for installing the hosted Mintlify Index MCP server.

SKILL.md adds mint index to the one-line CLI cheat sheet (with a short note that it configures coding agents).

reference/cli.md adds an MCP setup section: what the command installs (mintlify-index at https://index.mintlify.com/mcp), how it differs from the per-site Docs MCP, client flags (--claude, --cursor, etc.), --project / --yes, rerun and invalid-config behavior, the generated usage rule (except Zed), and a table of global vs project config paths per client.

^{Reviewed by Cursor Bugbot for commit ee65bf7. 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 (UTC)
mintlify	🟢 Ready	View Preview	Aug 7, 2026, 4:10 PM

[mintlify]

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

Project	Status	Preview	Updated (UTC)
tomee	🟢 Ready	View Preview	Aug 7, 2026, 4:11 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.