Agent skill sync with docs: correct admin MCP save modes

[mintlify]

Summary

Sync the canonical Mintlify skill's admin MCP save behavior with the current MCP publishing documentation.

Changes

• SKILL.md (Mintlify Admin section): document mode: "auto" as the default for save, including immediate merge when the deployment's publishing setting allows direct pushes and the deploy branch isn't protected; clarify "pr" and "commit" modes; note that changing the publishing setting requires the admin role.
• Removed the inaccurate claim that all changes "must be reviewed before merging."
• Reworded the workflow line from "call save to open a PR" to "call save to publish."

Context

• Triggered by ai/mintlify-mcp.mdx change in Update from code changes: MCP publishing toggle needs admin role #7133 (MCP publishing toggle now requires the admin role), which exposed the skill's stale save description (no auto mode, mandatory-review claim).
• npm test, npm run check, npm run build, and git diff --check all passed.
• The existing sync workflow will distribute the canonical skill to the Codex, Cursor, and Claude plugin repositories after merge.

---

Note

Low Risk
Documentation-only change to the Mintlify skill; no runtime or security behavior is modified.

Overview
Updates the canonical Mintlify agent skill so Mintlify Admin MCP guidance matches current publishing docs.

The intro now states edits stay on a session branch until save, and drops the old “must be reviewed before merging” wording. The workflow step says save to publish instead of always opening a PR.

The save tool entry documents mode: "auto" (default) with immediate merge when publishing settings allow direct pushes and the deploy branch isn’t protected, plus pr and commit modes and that changing the publishing setting needs the admin role.

^{Reviewed by Cursor Bugbot for commit 719aab9. 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 27, 2026, 4:15 PM

[mintlify]

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

Project	Status	Preview	Updated (UTC)
tomee	🟡 Building	–	Aug 27, 2026, 4:13 PM

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