[try 2] Update docs for registry server v0.6.3

[rdimitrov]

Description

Type of change

• New documentation
• Documentation update
• Bug fix (typo, broken link, etc.)
• Navigation/structure change

Related issues/PRs

Screenshots

Submitter checklist

Content and formatting

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

Navigation

• New pages include a frontmatter section with title and description at a minimum
• Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files
• Redirects added to vercel.json for moved, renamed, or deleted pages (i.e., if the URL slug changed)

Reviewer checklist

Content

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

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
docs-website	Ready	Preview, Comment	Mar 16, 2026 3:07pm

[Copilot]

Pull request overview

Adds documentation for ToolHive Registry Server “skills” and updates existing Registry Server docs/config references to include skills and revised defaults.

Changes:

• Adds new “Understanding skills” concept page and “Manage skills” how-to guide.
• Updates Registry Server overview/index pages and sidebar navigation to include skills content.
• Updates Registry Server configuration docs to reflect a larger maxMetaSize default and documents a new registry-title annotation.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
sidebars.ts	Adds Skills pages to the Registry Server and Concepts sidebar sections.
docs/toolhive/guides-registry/skills.mdx	New how-to guide for publishing/listing/retrieving/deleting skills via the extensions API.
docs/toolhive/guides-registry/intro.mdx	Mentions skills in the Registry Server overview and adds links to the new guide.
docs/toolhive/guides-registry/index.mdx	Updates section description to include skills.
docs/toolhive/guides-registry/database.mdx	Updates maxMetaSize default value in examples and tables.
docs/toolhive/guides-registry/configuration.mdx	Updates maxMetaSize, adds skills link under managed registry operations, and documents registry-title annotation.
docs/toolhive/concepts/skills.mdx	New concept page defining skills, structure, and versioning.

[danbarr]

Review

Meaningfully better than both #601 and #603. The primary blocker from those rounds — the missing consumer workflow explanation — is now addressed with the "Current status and what's next" section in both the concept page and guide. The explicit "planned for a future release" language is exactly what was needed.

One issue to fix

API path inconsistency in concepts/skills.mdx line 101

Line 39 (correctly) uses /{registryName}/v0.1/x/dev.toolhive/skills, but line 101 drops the prefix:

The skills API is available as an extension endpoint on the Registry server (/v0.1/x/dev.toolhive/skills).

Should be /{registryName}/v0.1/x/dev.toolhive/skills to match line 39 and the guide.

What's improved vs. prior rounds

• Consumer workflow gap (the blocker from Update docs for registry server v0.6.3 #603): Addressed — the "planned for a future release" note is present in both the concept page and the guide.
• Concept page scope: Substantially cleaner than Document skills feature and update registry server docs for v0.6.3 #601's field-dump "Key properties" section. The Mermaid diagram is a good addition.
• Guide structure: Remains task-organized (publish → list → retrieve → delete), not the old endpoint-ordered approach from Document skills feature and update registry server docs for v0.6.3 #601.
• {registryName} placeholder clarity: The guide explains the placeholder with a concrete example, which addresses the Copilot ambiguity comment.
• intro.mdx and sidebars.ts: Now correctly reference skills.
• Status casing: The request/response casing difference is explained inline (guide lines 69–70), which is the right call.

🤖 Generated with Claude Code

[rdimitrov]

@danbarr - addressed the comment above 👍