Agent skill sync with docs: analytics gate, save modes, pipes

[mintlify]

Summary

Syncs the canonical Mintlify agent skill with authoritative docs changes from the last review window.

Changes

• reference/cli.md: mint analytics now notes the Pro or Enterprise plan requirement (from cli/commands.mdx, Update from code changes: mint analytics CLI plan note and overview link #7094).
• SKILL.md: save tool description now covers mode: "auto" (default) and the Push directly to your deploy branch publishing setting, replacing the outdated "all changes must be reviewed before merging" claim (from ai/mintlify-mcp.mdx, Update from code changes: document MCP publishing toggle #7096).
• SKILL.md: added common mistake about escaping literal pipes (\|) in table cells, including inside inline code (from create/list-table.mdx, docs: explain escaping pipes in tables #7079).

Context

Ignored translation-only, formatting, editor-docs restructure, MDX extension, and llms.txt split-index changes as they don't affect facts the skill teaches.

Validation: npm run check, npm run build, and git diff --check passed. npm test cannot run in this environment because the ajv dev dependency is not installed and installs are blocked; no test fixtures were affected by these Markdown-only edits.

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

---

Note

Low Risk
Markdown-only edits to agent skill reference files; no runtime, auth, or application code changes.

Overview
Updates the canonical Mintlify agent skill so agents follow current product behavior instead of outdated MCP and CLI docs.

Mintlify Admin (save) — Replaces the “review before merge” framing with session branches until save publishes. Documents default mode: "auto" (follows Push directly to your deploy branch), explicit mode: "pr" / mode: "commit", and that branch protection still forces a PR.

CLI analytics — Notes that mint analytics requires login and a Pro or Enterprise plan.

Authoring — Adds a common-mistake entry: escape literal | in table cells as \|, including inside inline code.

^{Reviewed by Cursor Bugbot for commit 23e0b6d. 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 26, 2026, 4:13 PM

[mintlify]

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

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

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

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 23e0b6d. Configure here.}

[cursor]

Missing Kiro version bump

Medium Severity

These edits change the generated Kiro skill, but pluginManifest.version in targets/kiro.json stays at 1.0.0. The agent-context README treats that field as the release version and requires a SemVer bump before merge whenever the generated Kiro skill changes, so Kiro update checks may not pick up this sync.

Additional Locations (1)

• agent-context/context/skills/mintlify/reference/cli.md#L39-L40

 

^{Reviewed by Cursor Bugbot for commit 23e0b6d. Configure here.}