Agent skill sync with docs: document admin MCP navigationErrors

[mintlify]

Summary

Teach the Mintlify skill that admin MCP node tools return navigationErrors when navigation becomes invalid.

Changes

• agent-context/context/skills/mintlify/SKILL.md: the node tools entry now says that create_node, update_node, move_node, and delete_node return a navigationErrors field when the navigation is invalid (for example, a page at the root next to tabs). It also tells agents to fix these errors before save, because Mintlify can drop invalid nodes from the published navigation.

Context

• Source: ai/mintlify-mcp.mdx (Update from code changes: document admin MCP navigationErrors #7549, "document navigationErrors in admin MCP node tool responses").
• Other changes in this window were translations, wording fixes, or unrelated pages, so they needed no skill update.

Validation

• git diff --check passed.
• npm test, npm run check, and npm run build could not pass. The ajv dependency isn't installed in the environment and couldn't be installed. The same failure happens on main without this change, so CI should confirm these checks.
• After merge, the existing sync workflow will distribute the canonical skill.

---

Note

Low Risk
Documentation-only change to the Mintlify agent skill; no runtime or API behavior changes.

Overview
Updates the Mintlify agent skill so Admin MCP navigation tree tools document navigationErrors: when create_node, update_node, move_node, or delete_node leave invalid navigation (e.g. a root-level page beside tabs), the response includes that field. Agents are told to fix those errors before save, because invalid nodes may be dropped from published navigation.

This aligns the skill with the product docs in ai/mintlify-mcp.mdx.

^{Reviewed by Cursor Bugbot for commit e6cc9ed. 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
mintlify	🟢 Ready	View Preview	Sep 29, 2026, 4:08 PM