update-nav

Update docs.json navigation by adding new pages to appropriate groups.

427|237|Updated Mar 23, 2023
One-click install
npx skills add https://github.com/mintlify/docs --skill update-nav
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-nav
Source: https://github.com/mintlify/docs/tree/main/.claude/skills/update-nav
Command: npx skills add https://github.com/mintlify/docs --skill update-nav

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams keep the documentation navigation in sync by automatically adding new pages to docs.json and organizing them into the correct navigation groups based on the user journey.

Core Features & Use Cases

  • Identify the target page path and determine the appropriate navigation group (e.g., Get started, Customize, Deploy, Settings).
  • Update docs.json with the new page entry in the correct group while preserving formatting and existing structure.
  • Show a change diff to confirm what was added and where.

Quick Start

Use the update-nav skill to add a new page path to docs.json in the correct navigation group.

Frequently Asked Questions about update-nav

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

FAQPage Schema
How do I automatically add new pages to docs.json navigation?

Docs.json navigation groups are determined by matching the target page path against predefined user journey categories like Customize, Deploy, or Get started, ensuring new pages align logically with the existing sidebar structure.

What is the best way to keep documentation navigation in sync with new pages?

Yes, the update process validates JSON syntax and preserves existing formatting. It modifies the docs.json structure by adding the new page entry to the appropriate group without breaking the current file layout.

How does this automation determine the correct sidebar group for a new docs page?

This automation determines the correct sidebar group by analyzing the new page's path and matching it to predefined user journey categories in your docs.json, such as Get started, Customize, Deploy, or Settings.

Can I see what changes were made to docs.json after updating the navigation?

Yes, you can see a change diff confirming exactly what was added and where, ensuring your docs.json navigation update is transparent and verifiable before finalizing.