金色时刻 · 15:48
让好资源,触手可及
AGENT SKILL

update-nav

update-nav 是面向文档处理的 Agent Skill,来自 mintlify/docs。查看技能说明、操作步骤与使用约定,并通过原项目了解详细用法。

Add new pages to docs.json navigation structure. Updates navigation groups based on user journey (Customize, Deploy, etc.). Use when the user asks to add a page to navigation, update docs.json, add to nav, or include a new page in the sidebar.

SKILL.md

下载 MD ↓
nameupdate-nav
descriptionAdd new pages to docs.json navigation structure. Updates navigation groups based on user journey (Customize, Deploy, etc.). Use when the user asks to add a page to navigation, update docs.json, add to nav, or include a new page in the sidebar.

Update Navigation

Add new documentation pages to the docs.json navigation structure.

Instructions

  1. Identify the page: Determine which page needs to be added to navigation - If not specified, ask the user which file/page to add - Confirm the file path is correct (relative to docs root)

  2. Determine navigation group: Figure out where in the navigation this belongs - Ask which navigation group it should go in if not specified - Common groups align with user journey: "Get started", "Customize", "Deploy", "Settings", etc. - Read docs.json to see current navigation structure and group names

  3. Read current docs.json: - Understand the existing navigation structure - Find the correct group to add to - Note the format and patterns used

  4. Update docs.json: - Add the new page entry to the appropriate navigation group - Maintain consistent formatting - Preserve alphabetical or logical ordering within the group if applicable - Ensure proper JSON syntax

  5. Show changes: - Show the user what was added to docs.json - Confirm the placement is correct

Navigation structure notes

  • Pages are organized by user journey, not by file structure
  • Navigation group names should match existing patterns
  • Each entry typically includes just the file path (e.g., "content/components/accordions")
  • Only update the English language section of the docs.json navigation. Updates to all translated content, including docs.json, are handled automatically after changes are made to English language files

Example

If user says "Add the new dark-mode.mdx page to the Customize navigation":

  1. Verify file exists at the specified path
  2. Read docs.json to find the "Customize" group
  3. Add "content/settings/dark-mode" to the appropriate location in that group
  4. Show the diff for confirmation

来源:mintlify/docs · MIT 许可 · 许可原文 · MD 为来源页保存的历史版本