skills.rest
gocobalt
gocobaltOFFICIAL
Explore all skills by this author →
WebsiteGitHub

update-nav

Insert new page entries into docs.json navigation groups and present a diff.

1|1|Updated Sep 28, 2023
Search Tags:#workflow#documentation#navigation#update#docs.json#page addition
One-click install
npx skills add https://github.com/gocobalt/mintlify-docs --skill update-nav-gocobalt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-nav
Source: https://github.com/gocobalt/mintlify-docs/tree/main/.agents/skills/mintlify/.claude/skills/update-nav
Command: npx skills add https://github.com/gocobalt/mintlify-docs --skill update-nav-gocobalt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps docs navigation in sync by updating docs.json when new pages exist or navigation groups change.

Core Features & Use Cases

  • Identify the page to add and its target navigation group
  • Read the existing docs.json to locate the correct group and formatting
  • Insert the new page entry in the proper location and format
  • Show the changes and confirm placement
  • Use cases include adding a page to navigation, placing a new page under a sidebar group, or reorganizing navigation

Quick Start

Identify the page path and target navigation group, update docs.json with the new entry, and confirm the changes.

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?▼

To add a new page to docs.json navigation, identify the page path and target sidebar group, then insert the new entry in the proper format and location within the file.

What is the best way to update docs.json when adding documentation pages?▼

Updating docs.json requires reading the existing file to locate the correct navigation group, inserting the new page entry in the matching format, and confirming the placement to keep navigation in sync.

How does adding a page to a navigation group work?▼

Adding a page to a navigation group works by reading the existing docs.json structure, determining the appropriate group for the new page, and inserting the entry in the correct format.

Can I reorganize existing sidebar groups in docs.json?▼

Yes, you can reorganize navigation by reading docs.json, moving page entries to different sidebar groups, and updating the formatting to maintain a synchronized documentation structure.

Why does my new documentation page not appear in the sidebar?▼

A new page does not appear in the sidebar when docs.json is not updated; you must insert the new page entry under the correct navigation group for it to display properly.

Do I need to manually format a new page entry in docs.json?▼

You must format the new page entry to match the existing docs.json structure, ensuring the page path and navigation group placement align with the current file formatting.

Related Skills

Explore More Content & Communication Skills→
socrateasehqsocrateasehq

update-nav

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

Official
Intermediate
akash-mondalakash-mondal

update-nav

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

Community
Intermediate
faw01faw01
18

mintlify

Create and maintain Mintlify documentation sites with docs.json and MDX.

Community
Intermediate
DomoAppsDomoApps
7

add-to-nav

Insert or move pages in Mintlify docs.json navigation with JSON validation.

Official
Intermediate