Skip to content

Document the console Skills catalog - #1348

Draft
kantord wants to merge 1 commit into
mainfrom
add-console-skills-docs
Draft

kantord wants to merge 1 commit into
mainfrom
add-console-skills-docs

Conversation

@kantord

@kantord kantord commented Nov 16, 2026

Copy link
Copy Markdown
Member

Description

Documents the Stacklok Enterprise console's Skills feature and corrects pages that described the Registry Server as the source of skills in the console.

New page: platform/enterprise-manager/skills.mdx ("Share skills with your organization")

  • Admin flow: prepare a Git repository, import it with Configure source, grant skills to groups (one at a time with Edit access or in bulk with Assign groups / Remove groups), Disable, Update all, and Delete source.
  • User flow: browse Skills, open a skill, Download the zip, and extract it into an AI client's skills directory.
  • Notes that this catalog lives in the Enterprise Manager and is separate from the Registry Server skills that the Stacklok CLI installs with thv skill install.

The page sits under Enterprise Manager because the Enterprise Manager's Catalog module serves every skills route. This follows the console page's rule that each administrative area is documented with the component that provides it.

Corrections

The classic console browsed skills from the Registry Server, but that UI is gone. Today the Registry Server serves MCP servers to the console and skills to the Stacklok CLI.

  • enterprise-platform/index.mdx: the architecture paragraph now credits the Enterprise Manager with the skills catalog and links to the new page.
  • configure-registry-server.mdx: the intro is scoped to the CLI, and a note points to the console Skills page.
  • deployment.mdx: the database prerequisite and the values comment no longer say the console reads skills from the Registry Server.
  • enterprise-console/index.mdx: adds Skills to the list of administrative areas.

airgap-install.mdx, distributed-deployments.mdx, and the Registry table in platform/index.mdx still say the Registry Server holds skills. That's accurate, because it serves them to the CLI, so those pages are unchanged.

Facts were verified against SEP origin/main: the UI labels come from the skills-admin and skills-user components, the import and sync rules from enterprise/toolhive-enterprise/docs/design/skills-catalog.md, and the console behavior from enterprise/toolhive-cloud-ui/docs/design/skills-admin.md and skills-catalogue.md.

Merge timing: the feature is still behind the admin_skills and skills flags. Merge this after the flag removal ships in a release.

Type of change

  • New documentation
  • Documentation update

Related issues/PRs

  • stacklok/stacklok-enterprise-platform#6752 (draft) removes the flags so Skills ships enabled
  • stacklok/stacklok-enterprise-platform#5188, #5777, #5778 (the feature)

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 (no URL changes)

Reviewer checklist

Content

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

Fully or partially written by an AI agent.

🤖 Generated with Claude Code

Add a how-to for importing skills from Git, granting them to groups,
and downloading them in the console. Correct pages that said the
console reads skills from the Registry Server: it serves MCP servers to
the console and skills to the Stacklok CLI.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings November 16, 2026 18:34
@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
docs-website Ready Ready Preview Nov 16, 2026 6:37pm UTC

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Upstream sources returned 404, blocking independent verification of key behavior, and a source-capable reviewer must confirm that #6752’s required flag-removal release has shipped before merge.

No open issues 🎉

What changed in this PR

Documents the Stacklok Enterprise console’s Skills catalog and clarifies its separation from Registry Server skills installed through the Stacklok CLI.

Changes:

  • Adds administrator workflows for importing, granting access to, updating, and removing skills, plus user download instructions.
  • Corrects architecture and deployment descriptions to distinguish the two skills catalogs.
  • Adds sidebar navigation and links from related platform pages.
File Description
sidebars.ts Adds Skills under Enterprise Manager.
docs/​platform/​enterprise-platform/​index.mdx Identifies Enterprise Manager as the console’s skills catalog provider.
docs/​platform/​enterprise-platform/​deployment.mdx Corrects database prerequisite wording and Registry Server configuration comments.
docs/​platform/​enterprise-platform/​configure-registry-server.mdx Clarifies Registry Server’s role and links to console skills guidance.
docs/​platform/​enterprise-manager/​skills.mdx Adds skills administration, download, and troubleshooting guidance.
docs/​platform/​enterprise-console/​index.mdx Links Skills from the administrative areas list.

Review effort: Balanced

This branch was successfully deployed

1 active deployment
Preview — 5a59f39f Deployed Nov 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants