update-nav

Update docs.json navigation entries with validated relative file paths.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/akash-mondal/mintlify-docs --skill update-nav-akash-mondal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-nav
Source: https://github.com/akash-mondal/mintlify-docs/tree/main/.agents/skills/mintlify/.claude/skills/update-nav
Command: npx skills add https://github.com/akash-mondal/mintlify-docs --skill update-nav-akash-mondal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Updates the docs.json navigation structure to reflect new pages and user journeys, ensuring navigation stays accurate and discoverable.

Core Features & Use Cases

  • Identify which page to add to navigation and confirm the relative file path.
  • Determine the correct navigation group by reviewing existing docs.json and user journey mappings.
  • Update docs.json with the new page entry, preserving formatting and group order.

Quick Start

Specify the file path and target navigation group to add, and I will update docs.json accordingly.

Frequently Asked Questions about update-nav

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new page to Mintlify docs.json navigation?

To add a new page to Mintlify docs.json navigation, specify the relative file path and target navigation group, and the structure updates accordingly while preserving established JSON syntax and group order.

How do I keep my documentation navigation in sync with new pages?

Documentation navigation stays in sync by updating docs.json entries to include newly requested pages, referencing the current structure and user journey mappings to maintain accurate content discoverability.

Does updating docs.json navigation preserve existing group order?

Yes, updating docs.json navigation preserves established group order by referencing the current structure, validating relative file paths, and enforcing correct JSON syntax during the new page insertion process.

What is the best way to structure user journeys in Mintlify navigation?

Structuring user journeys in Mintlify navigation requires mapping new page entries to existing docs.json navigation groups, ensuring relative file paths align with the established content structure and discoverability flow.

How do I validate relative file paths when updating docs.json?

Validating relative file paths when updating docs.json involves checking the new page entry against the current navigation structure, enforcing correct JSON syntax, and confirming the path matches the target group location.

Why does my docs.json navigation break after adding a new page?

Docs.json navigation breaks after adding a new page when JSON syntax is incorrect, relative file paths are invalid, or established group order is disrupted during manual content structure updates.