Add pattern consistency and admonition weight checks to docs-review skill

[danbarr]

Description

Adds two new review checks to the docs-review skill that were identified as gaps during the editorial review of #685:

• Pattern consistency for peer concepts (Section Structure and Navigation): When a PR introduces a new resource type or component that has established peers, check whether it follows the same documentation pattern. Catches cases like a new CRD being documented only as a subsection when its peers each have dedicated pages.
• Admonition weight (Structure and Length): Tips, notes, and warnings should be supplementary. If an admonition is the only place a feature is documented, it should be promoted to a proper section with ToC visibility.

Type of change

• Documentation update

Related issues/PRs

• Part 1: Update docs for ToolHive v0.17.0 #685 (review that surfaced the gaps)
• Add dedicated Operator guide page for MCPServerEntry #688 (MCPServerEntry page - example of pattern consistency gap)
• Promote authServerRef tip to a proper subsection in auth guide #689 (authServerRef tip - example of admonition weight gap)

Submitter checklist

Content and formatting

• I have reviewed the content for technical accuracy
• I have reviewed the content for spelling, grammar, and style

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs-website	Ready	Preview, Comment	Apr 10, 2026 1:14am

[Copilot]

Pull request overview

Updates the docs-review skill checklist to cover two editorial gaps identified during review of prior documentation changes, strengthening structural and navigational review criteria across the ToolHive docs set.

Changes:

• Add an Admonition weight check to flag when key feature documentation is incorrectly buried inside tips/notes/warnings.
• Add a Pattern consistency for peer concepts check to ensure new resources/features follow established doc patterns used by comparable “peer” concepts (e.g., dedicated pages and parallel placement).