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..9bbd7e41 --- /dev/null +++ b/blog/toolhive-updates/2026-04-06-updates.mdx @@ -0,0 +1,84 @@ +--- +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 supported 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://agentskills.io/specification), an open +standard for AI coding agents. See the +[skills management guide](/toolhive/guides-cli/skills-management) for the full +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 + +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).