[handbookbot] Documentation Audit — 2026-05-04

[github-actions]

Summary

48 of 48 total components are documented. 0 missing docs, 0 stale docs, 0 plugin index gaps. However, 2 naming discrepancies were found between plugin component identifiers and their corresponding .mdx filenames — these could cause confusion when cross-referencing docs to source or when building automated linking.

Missing Documentation

✅ None — all components have a corresponding .mdx file.

Stale Documentation

✅ None — all .mdx files correspond to existing plugin components.

Naming Discrepancies

These components exist and are documented, but the .mdx filename doesn't match the component's identifier as reported by the discover script:

Component ID (discover)	Type	Plugin	Doc File	Issue
glab-skill	skill	handbook-glab	skills/glab.mdx	Skill dir is glab-skill, doc is glab.mdx
five-whys	command	handbook-extras	commands/5whys-prompt.mdx	Command is five-whys, doc file is 5whys-prompt.mdx (title in file is correct: /five-whys)

Plugin Index Gaps

✅ None — all 18 marketplace plugins listed in .claude-plugin/marketplace.json are present in website/docs/plugins.md.

LSP Servers

✅ LSP servers are already categorized — lsp-servers/csharp.mdx exists for the csharp LSP from handbook-csharp-lsp.

Suggested Fixes

• Rename website/docs/component-reference/commands/5whys-prompt.mdx → five-whys.mdx (the title is already correct, only the filename needs to change)
• Rename website/docs/component-reference/skills/glab.mdx → glab-skill.mdx (or rename the skill directory from glab-skill to glab for consistency — the latter may be cleaner)
• Update any sidebars config or internal links that reference the old filenames after renaming

Generated by Handbookbot: Docs Audit

• expires on May 18, 2026, 10:17 PM UTC