Skip to content

fix(docs): regenerate skill docs to fix stale cross-links, add tool-search to sidebar - #49444

Closed
yapsrubricsz0 wants to merge 1 commit into
NousResearch:mainfrom
yapsrubricsz0:fix/auto-stale-skill-links-and-sidebar
Closed

fix(docs): regenerate skill docs to fix stale cross-links, add tool-search to sidebar#49444
yapsrubricsz0 wants to merge 1 commit into
NousResearch:mainfrom
yapsrubricsz0:fix/auto-stale-skill-links-and-sidebar

Conversation

@yapsrubricsz0

Copy link
Copy Markdown
Contributor

Problem

Auto-generated skill documentation pages had stale cross-links to skills that had been:

  • Moved from bundled to optional (pixel-art, baoyu-comic, subagent-driven-development)
  • Renamed or removed entirely (native-mcp, webhook-subscriptions, debugging-hermes-tui-commands, media-spotify)
  • The tool-search feature page was orphaned — present in the filesystem but not registered in the sidebar

Solution

Re-ran the skill doc generator (website/scripts/generate-skill-docs.py) which:

  • Rebuilds the skill index from the current SKILL.md files, cross-referencing existing skills
  • Skills that no longer exist are rendered as plain code references instead of broken links
  • Skills that moved to optional now link to their correct optional/ path

Additionally added tool-search to the sidebar under Features → Core, right after tools.

Testing

  • Verified generator output: confirmed broken link targets like /docs/user-guide/skills/bundled/mcp/mcp-native-mcp are now rendered as plain code references
  • Verified moved skills like pixel-art now link to /docs/user-guide/skills/optional/creative/creative-pixel-art
  • Verified user-guide/features/tool-search is now listed in the Features → Core sidebar section

@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have labels Jun 20, 2026
@teknium1

Copy link
Copy Markdown
Contributor

Merged via PR #49914 (docs salvage cluster). Your commit was cherry-picked onto current main with your authorship preserved in git log — merged with rebase so it lands under your name. Thanks for the contribution! Note: your commit was authored under a generic ubuntu@localhost.localdomain identity, so we re-authored it to your GitHub account to credit you correctly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants