From 46da13f48ebb5fc607bf977a2c2c22a1f1e11eb3 Mon Sep 17 00:00:00 2001 From: Dan Barr <6922515+danbarr@users.noreply.github.com> Date: Mon, 6 Apr 2026 11:47:18 -0400 Subject: [PATCH 1/3] Add April 6 product update: agent skills Co-Authored-By: Claude Opus 4.6 (1M context) --- blog/toolhive-updates/2026-04-06-updates.mdx | 83 ++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 blog/toolhive-updates/2026-04-06-updates.mdx diff --git a/blog/toolhive-updates/2026-04-06-updates.mdx b/blog/toolhive-updates/2026-04-06-updates.mdx new file mode 100644 index 00000000..2a943941 --- /dev/null +++ b/blog/toolhive-updates/2026-04-06-updates.mdx @@ -0,0 +1,83 @@ +--- +title: Reusable agent skills across CLI and Registry +sidebar_label: 'Apr 6: Agent skills' +description: + ToolHive adds agent skills support across the CLI and Registry Server, letting + teams create, publish, and install reusable instruction bundles that teach AI + agents how to use MCP tools effectively. +--- + +ToolHive now supports agent skills - reusable bundles of instructions and +configuration that teach AI agents how to perform specific tasks. MCP servers +give agents the raw tools they can call; skills give them the knowledge of when, +why, and how to use those tools effectively. With ToolHive, teams can create +skills, publish them to a registry, and install them across AI clients from a +single CLI. + +{/* truncate */} + +## ToolHive CLI: Install, package, and publish skills + +The ToolHive CLI adds full lifecycle management for agent skills, from discovery +through distribution: + +- **Install skills from multiple sources** including the ToolHive Registry + Server, OCI registries, or Git repositories. ToolHive writes skill files to + your AI client's skills directory automatically, so the agent discovers them + without manual file management. +- **Scope skills to users or projects** depending on whether you want a skill + available across all your work or limited to a specific codebase. User-scoped + skills install globally, while project-scoped skills activate only when + working in that repo. +- **Build and publish skills** as OCI artifacts to share them with your team + through any container registry. The CLI handles validation, packaging, and + pushing using your existing registry credentials. + +Skills follow the +[Agent Skills specification](https://github.com/anthropics/agent-skills-spec), +an open standard supported by Claude Code, GitHub Copilot, Cursor, OpenCode, and +other AI coding agents. See the +[skills management guide](/toolhive/guides-cli/skills-management) for the full +CLI reference. + +## Registry Server: Centralized skill discovery and versioning + +The [Registry Server](https://github.com/stacklok/toolhive-registry-server) adds +an extensions API for publishing and managing skills alongside your MCP server +registry: + +- **Publish versioned skills** with namespace isolation using reverse-DNS + notation to prevent naming collisions across teams. The registry tracks + multiple versions of each skill and automatically updates the latest pointer + as new versions are published. +- **Search and filter skills** by keyword, status, or namespace with + cursor-based pagination, so teams can discover relevant skills from large + catalogs without scrolling through everything. +- **Lifecycle management** lets you mark skills as active, deprecated, or + archived, giving platform teams clear controls over which skills are approved + for use across the organization. + +Skills are stored under a separate extensions API path and not intermixed with +MCP server entries. See the +[registry skills guide](/toolhive/guides-registry/skills) for the API reference +and publishing workflow. + +:::note + +Skills management in the ToolHive Desktop UI is coming soon, bringing discovery +and installation into the app alongside MCP server management. + +::: + +## Getting started + +For detailed release notes, check the project repositories: + +- [ToolHive Runtimes](https://github.com/stacklok/toolhive/releases) (CLI and + Kubernetes Operator) +- [ToolHive Desktop UI](https://github.com/stacklok/toolhive-studio/releases) +- [ToolHive Cloud UI](https://github.com/stacklok/toolhive-cloud-ui/releases) +- [ToolHive Registry Server](https://github.com/stacklok/toolhive-registry-server/releases) + +You can find all ToolHive documentation on the +[Stacklok documentation site](/toolhive). From edd49912be66aeffb3b67d6b4de8008b76299e6d Mon Sep 17 00:00:00 2001 From: Dan Barr <6922515+danbarr@users.noreply.github.com> Date: Mon, 6 Apr 2026 11:51:27 -0400 Subject: [PATCH 2/3] Fix Agent Skills specification URL Co-Authored-By: Claude Opus 4.6 (1M context) --- blog/toolhive-updates/2026-04-06-updates.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/blog/toolhive-updates/2026-04-06-updates.mdx b/blog/toolhive-updates/2026-04-06-updates.mdx index 2a943941..fb4789a5 100644 --- a/blog/toolhive-updates/2026-04-06-updates.mdx +++ b/blog/toolhive-updates/2026-04-06-updates.mdx @@ -34,9 +34,9 @@ through distribution: pushing using your existing registry credentials. Skills follow the -[Agent Skills specification](https://github.com/anthropics/agent-skills-spec), -an open standard supported by Claude Code, GitHub Copilot, Cursor, OpenCode, and -other AI coding agents. See the +[Agent Skills specification](https://agentskills.io/specification), an open +standard supported by Claude Code, GitHub Copilot, Cursor, OpenCode, and other +AI coding agents. See the [skills management guide](/toolhive/guides-cli/skills-management) for the full CLI reference. From d190cd4b8cc5aadbb7f056c9751f38fe34d279b2 Mon Sep 17 00:00:00 2001 From: Dan Barr <6922515+danbarr@users.noreply.github.com> Date: Mon, 6 Apr 2026 11:54:52 -0400 Subject: [PATCH 3/3] Qualify skills client support claims Remove specific client names that contradict the client compatibility matrix and add qualifier for supported clients. Co-Authored-By: Claude Opus 4.6 (1M context) --- blog/toolhive-updates/2026-04-06-updates.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/blog/toolhive-updates/2026-04-06-updates.mdx b/blog/toolhive-updates/2026-04-06-updates.mdx index fb4789a5..9bbd7e41 100644 --- a/blog/toolhive-updates/2026-04-06-updates.mdx +++ b/blog/toolhive-updates/2026-04-06-updates.mdx @@ -11,8 +11,8 @@ ToolHive now supports agent skills - reusable bundles of instructions and configuration that teach AI agents how to perform specific tasks. MCP servers give agents the raw tools they can call; skills give them the knowledge of when, why, and how to use those tools effectively. With ToolHive, teams can create -skills, publish them to a registry, and install them across AI clients from a -single CLI. +skills, publish them to a registry, and install them across supported AI clients +from a single CLI. {/* truncate */} @@ -35,10 +35,11 @@ through distribution: Skills follow the [Agent Skills specification](https://agentskills.io/specification), an open -standard supported by Claude Code, GitHub Copilot, Cursor, OpenCode, and other -AI coding agents. See the +standard for AI coding agents. See the [skills management guide](/toolhive/guides-cli/skills-management) for the full -CLI reference. +CLI reference and the +[client compatibility page](/toolhive/reference/client-compatibility) for the +current list of skill-capable clients. ## Registry Server: Centralized skill discovery and versioning