update-nav

Update docs.json navigation with new page entries and show diffs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates updating the docs.json navigation so new pages are added to the correct navigation groups and maintain consistent structure across the docs.

Core Features & Use Cases

  • Identify the page to add and verify the file path relative to docs root
  • Read docs.json to locate the appropriate navigation group and ensure consistency with existing structure
  • Update docs.json with the new page entry, preserving formatting and order
  • Show the diff and confirm changes to the user

Quick Start

Provide the file path and target navigation group, then apply the update to docs.json and review the resulting diff.

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 docs.json navigation groups?

To update docs.json navigation, identify the page file path relative to the docs root, determine the correct navigation group, insert the new page entry, and review the resulting diff to ensure proper formatting and order are preserved.

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

Keeping docs sidebar navigation in sync involves reading the existing docs.json structure, matching the new page to an appropriate group, and updating the file while maintaining the established hierarchy and formatting conventions.

How does docs.json navigation grouping work for user journeys?

Docs.json navigation grouping organizes pages into logical categories like Get started, Customize, or Deploy, ensuring that new pages are added to the correct group to maintain consistent structure across the documentation site.

Can I update docs.json navigation without breaking existing page grouping?

Yes, updating docs.json preserves existing page grouping by consulting the current structure, verifying the file path, and ensuring the new entry matches the established formatting and order before applying changes.

Why does my docs sidebar show incorrect navigation groups after adding pages?

Incorrect navigation groups occur when new pages are added without consulting the existing docs.json structure, causing entries to be placed in the wrong group or losing formatting consistency, which can be fixed by verifying the correct group and diff.