From f36735395e0030f5fe232431600687668b180e9e Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Thu, 7 May 2026 18:05:25 +0000 Subject: [PATCH 1/5] Update stacklok/toolhive-studio to v0.34.0 Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> --- .github/upstream-projects.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/upstream-projects.yaml b/.github/upstream-projects.yaml index cdf418ff..a3d20b11 100644 --- a/.github/upstream-projects.yaml +++ b/.github/upstream-projects.yaml @@ -71,7 +71,7 @@ projects: - id: toolhive-studio repo: stacklok/toolhive-studio - version: v0.33.1 + version: v0.34.0 docs_paths: - docs/toolhive/guides-ui From a141f79ecd81dd29f88f14c6c7318575f98e32aa Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 7 May 2026 18:13:11 +0000 Subject: [PATCH 2/5] Document Skill Engineer agent and Skills picker in Playground --- SUMMARY.md | 12 ++++++ docs/toolhive/guides-ui/playground.mdx | 41 +++++++++++++++++++ .../guides-ui/skills-browse-install.mdx | 8 +++- docs/toolhive/guides-ui/skills-build.mdx | 14 +++++++ docs/toolhive/guides-ui/skills-manage.mdx | 9 ++++ 5 files changed, 82 insertions(+), 2 deletions(-) create mode 100644 SUMMARY.md diff --git a/SUMMARY.md b/SUMMARY.md new file mode 100644 index 00000000..db9ac8b4 --- /dev/null +++ b/SUMMARY.md @@ -0,0 +1,12 @@ +# Summary of changes + +- Added a **Built-in agents** section in `docs/toolhive/guides-ui/playground.mdx` covering the **ToolHive Assistant** and the renamed **Skill Engineer** built-in agents (PR #2184). +- Added an **Enable installed skills** subsection in `docs/toolhive/guides-ui/playground.mdx` describing the new Skills picker on the composer toolbar (PR #2184). +- Updated the **Version** field copy in `docs/toolhive/guides-ui/skills-browse-install.mdx` to cover the new tag/digest auto-split behavior on paste (PR #2185). +- Added a **Build a skill from the Playground** section in `docs/toolhive/guides-ui/skills-build.mdx` and a new **Audit an installed skill** section in `docs/toolhive/guides-ui/skills-manage.mdx`, both pointing at the Skill Engineer agent. + +Skipped (no doc impact this release): + +- PR #2192 (chat virtualization) — internal performance change. +- PR #2206 (Flatpak Docker Desktop socket) — Flatpak isn't a documented install method. +- PR #2187 (skill deep-links) — broader `toolhive-gui://` deep-link surface isn't documented yet; covering only the new skill intents would be inconsistent. Worth a future follow-up. diff --git a/docs/toolhive/guides-ui/playground.mdx b/docs/toolhive/guides-ui/playground.mdx index 887443ad..c95aaa93 100644 --- a/docs/toolhive/guides-ui/playground.mdx +++ b/docs/toolhive/guides-ui/playground.mdx @@ -93,6 +93,46 @@ To start using the playground: have access to all enabled MCP tools and can execute them based on your requests. +## Built-in agents + +The composer toolbar at the bottom of every chat thread includes an **Agent** +selector. ToolHive ships two built-in agents you can pick between, each with a +different system prompt and toolset: + +- **ToolHive Assistant**: a general-purpose assistant with access to every + enabled MCP tool. Use this for ad-hoc testing of MCP servers and for natural + language management of ToolHive itself (start/stop servers, inspect logs, and + similar tasks). +- **Skill Engineer**: a specialist for authoring and auditing + [agent skills](../concepts/skills.mdx). It can write a new `SKILL.md` plus + bundled files and build them into an OCI artifact through ToolHive's local + build API, or load an installed skill from disk and audit it against the spec. + +You can also create your own custom agents from **Playground** > **Agents** if +you want a different system prompt or model default. + +### Enable installed skills + +When you select the **Skill Engineer** agent, the composer toolbar shows a +**Skills** picker next to the Agent / MCP Servers / Model selectors. Use it to +toggle which [installed skills](./skills-manage.mdx) are visible to the agent in +the current chat: + +- The dropdown lists every skill on the **Installed** tab, deduplicated by name + and annotated with **User** or `` badges that show each install + location. +- A live count badge on the trigger reflects how many skills are currently + enabled. +- Selecting a skill exposes its `SKILL.md` and bundled files to the agent so it + can list, load, and read the contents on disk for an audit. +- **Clear enabled skills** wipes the allow-list. Uninstalling a skill from the + **Skills** page also removes it automatically the next time the picker + refreshes. + +The picker is greyed out for agents that don't bind the skills toolset (such as +the default ToolHive Assistant). Switch to **Skill Engineer** or any custom +agent that binds the skills tool bundle to enable it. + ## Using the playground ### Testing MCP server functionality @@ -211,6 +251,7 @@ and identify any issues with tool implementation or configuration. when testing untrusted MCP servers - Browse the [registry](./registry.mdx) to discover new MCP servers to test in the playground +- [Build or audit a skill](./skills.mdx) with the **Skill Engineer** agent ## Related information diff --git a/docs/toolhive/guides-ui/skills-browse-install.mdx b/docs/toolhive/guides-ui/skills-browse-install.mdx index 4182645b..795a9db6 100644 --- a/docs/toolhive/guides-ui/skills-browse-install.mdx +++ b/docs/toolhive/guides-ui/skills-browse-install.mdx @@ -42,8 +42,12 @@ The **Install skill** dialog asks for: `ghcr.io//skills/:`). - A Git URL of the form `git://host/owner/repo[@ref][#path/to/skill]`. -- **Version** (optional) - provided automatically when you start from a registry - skill. Leave blank to install the latest version. +- **Version** (optional) - prefilled automatically when you open the dialog from + a registry skill or local build. If you paste a tagged or digest-pinned + reference into the **Reference** field (for example, `my-skill:v1.0.0` or + `ghcr.io//skills/@sha256:`), ToolHive splits the suffix + into the **Version** field when you tab out, so you don't have to break the + reference up by hand. Leave the field blank to install the latest version. - **Scope** (required) - where the skill files are written on disk. Hover the **(i)** icon next to the field to see the inline tooltip: diff --git a/docs/toolhive/guides-ui/skills-build.mdx b/docs/toolhive/guides-ui/skills-build.mdx index 278bd055..97b6e8ca 100644 --- a/docs/toolhive/guides-ui/skills-build.mdx +++ b/docs/toolhive/guides-ui/skills-build.mdx @@ -65,6 +65,20 @@ ToolHive deletes the artifact from the local OCI store. When multiple tags share the same digest, the underlying blobs are retained until every tag pointing to that digest is removed. +## Build a skill from the Playground + +If you'd rather draft a skill conversationally, switch the +[Playground](./playground.mdx) agent to **Skill Engineer**. The agent guides you +through naming the skill, drafts the `SKILL.md` and any supporting files inside +the chat, and then calls ToolHive's local build API to produce an OCI artifact. + +A successful build renders a "Skill built" card inline in the chat with three +actions: **Install** (opens the **Install skill** dialog with the reference and +version pre-filled), **View details** (deep-links to the build on the **Local +Builds** tab), and **Copy name** (copies the bare skill name to the clipboard). +From there, the install and removal flows are identical to a build created from +the **Build skill** dialog. + ## Push a build to a remote registry Pushing to a remote container registry is currently a CLI-only operation. After diff --git a/docs/toolhive/guides-ui/skills-manage.mdx b/docs/toolhive/guides-ui/skills-manage.mdx index e3510632..0ec2d067 100644 --- a/docs/toolhive/guides-ui/skills-manage.mdx +++ b/docs/toolhive/guides-ui/skills-manage.mdx @@ -45,6 +45,15 @@ again. ::: +## Audit an installed skill + +To inspect a skill's `SKILL.md` and bundled files without leaving the desktop +app, switch the [Playground](./playground.mdx#built-in-agents) agent to **Skill +Engineer**, enable the skill in the composer toolbar's **Skills** picker, and +ask the agent to audit it. The agent reads the on-disk install, cross-checks +every file the body references against what's actually packaged, and returns a +PASS / PARTIAL / FAIL verdict. + ## Next steps - [Browse and install skills](./skills-browse-install.mdx) to add more skills From c221e6fb28cdc6e012dc667788d41e480ceae32b Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 7 May 2026 18:18:39 +0000 Subject: [PATCH 3/5] Editorial pass on Skill Engineer docs Tighten prose in the new Built-in agents and Skills picker sections: replace internal jargon (allow-list, "binds the skills toolset"), fix "greyed" -> "disabled", normalize "prefilled" to the project's "pre-filled" convention, and break a dense parenthetical action list in skills-build into a bulleted list. Co-Authored-By: Claude Opus 4.7 --- docs/toolhive/guides-ui/playground.mdx | 23 +++++++++---------- .../guides-ui/skills-browse-install.mdx | 8 +++---- docs/toolhive/guides-ui/skills-build.mdx | 17 +++++++++----- docs/toolhive/guides-ui/skills-manage.mdx | 4 ++-- 4 files changed, 28 insertions(+), 24 deletions(-) diff --git a/docs/toolhive/guides-ui/playground.mdx b/docs/toolhive/guides-ui/playground.mdx index c95aaa93..87408933 100644 --- a/docs/toolhive/guides-ui/playground.mdx +++ b/docs/toolhive/guides-ui/playground.mdx @@ -114,24 +114,23 @@ you want a different system prompt or model default. ### Enable installed skills When you select the **Skill Engineer** agent, the composer toolbar shows a -**Skills** picker next to the Agent / MCP Servers / Model selectors. Use it to -toggle which [installed skills](./skills-manage.mdx) are visible to the agent in -the current chat: +**Skills** picker next to the **Agent**, **MCP Servers**, and **Model** +selectors. Use it to toggle which [installed skills](./skills-manage.mdx) are +visible to the agent in the current chat: - The dropdown lists every skill on the **Installed** tab, deduplicated by name - and annotated with **User** or `` badges that show each install + and tagged with a **User** badge or the project name to show each install location. -- A live count badge on the trigger reflects how many skills are currently - enabled. +- A count badge on the trigger shows how many skills are currently enabled. - Selecting a skill exposes its `SKILL.md` and bundled files to the agent so it can list, load, and read the contents on disk for an audit. -- **Clear enabled skills** wipes the allow-list. Uninstalling a skill from the - **Skills** page also removes it automatically the next time the picker - refreshes. +- **Clear enabled skills** disables every skill at once. Uninstalling a skill + from the **Skills** page also removes it automatically the next time the + picker refreshes. -The picker is greyed out for agents that don't bind the skills toolset (such as -the default ToolHive Assistant). Switch to **Skill Engineer** or any custom -agent that binds the skills tool bundle to enable it. +The picker is disabled for agents that don't have access to skill tools, such as +the default ToolHive Assistant. Switch to **Skill Engineer** or a custom agent +configured with the skills toolset to enable it. ## Using the playground diff --git a/docs/toolhive/guides-ui/skills-browse-install.mdx b/docs/toolhive/guides-ui/skills-browse-install.mdx index 795a9db6..ecd7c725 100644 --- a/docs/toolhive/guides-ui/skills-browse-install.mdx +++ b/docs/toolhive/guides-ui/skills-browse-install.mdx @@ -42,12 +42,12 @@ The **Install skill** dialog asks for: `ghcr.io//skills/:`). - A Git URL of the form `git://host/owner/repo[@ref][#path/to/skill]`. -- **Version** (optional) - prefilled automatically when you open the dialog from - a registry skill or local build. If you paste a tagged or digest-pinned +- **Version** (optional) - pre-filled automatically when you open the dialog + from a registry skill or local build. If you paste a tagged or digest-pinned reference into the **Reference** field (for example, `my-skill:v1.0.0` or `ghcr.io//skills/@sha256:`), ToolHive splits the suffix - into the **Version** field when you tab out, so you don't have to break the - reference up by hand. Leave the field blank to install the latest version. + into the **Version** field when you tab out, so you don't have to split it + manually. Leave the field blank to install the latest version. - **Scope** (required) - where the skill files are written on disk. Hover the **(i)** icon next to the field to see the inline tooltip: diff --git a/docs/toolhive/guides-ui/skills-build.mdx b/docs/toolhive/guides-ui/skills-build.mdx index 97b6e8ca..c97b1e02 100644 --- a/docs/toolhive/guides-ui/skills-build.mdx +++ b/docs/toolhive/guides-ui/skills-build.mdx @@ -68,14 +68,19 @@ that digest is removed. ## Build a skill from the Playground If you'd rather draft a skill conversationally, switch the -[Playground](./playground.mdx) agent to **Skill Engineer**. The agent guides you -through naming the skill, drafts the `SKILL.md` and any supporting files inside -the chat, and then calls ToolHive's local build API to produce an OCI artifact. +[Playground](./playground.mdx#built-in-agents) agent to **Skill Engineer**. The +agent guides you through naming the skill, drafts the `SKILL.md` and any +supporting files inside the chat, and then calls ToolHive's local build API to +produce an OCI artifact. A successful build renders a "Skill built" card inline in the chat with three -actions: **Install** (opens the **Install skill** dialog with the reference and -version pre-filled), **View details** (deep-links to the build on the **Local -Builds** tab), and **Copy name** (copies the bare skill name to the clipboard). +actions: + +- **Install**: opens the **Install skill** dialog with the reference and version + pre-filled. +- **View details**: opens the build's row on the **Local Builds** tab. +- **Copy name**: copies the skill name to the clipboard. + From there, the install and removal flows are identical to a build created from the **Build skill** dialog. diff --git a/docs/toolhive/guides-ui/skills-manage.mdx b/docs/toolhive/guides-ui/skills-manage.mdx index 0ec2d067..ce3c03d2 100644 --- a/docs/toolhive/guides-ui/skills-manage.mdx +++ b/docs/toolhive/guides-ui/skills-manage.mdx @@ -51,8 +51,8 @@ To inspect a skill's `SKILL.md` and bundled files without leaving the desktop app, switch the [Playground](./playground.mdx#built-in-agents) agent to **Skill Engineer**, enable the skill in the composer toolbar's **Skills** picker, and ask the agent to audit it. The agent reads the on-disk install, cross-checks -every file the body references against what's actually packaged, and returns a -PASS / PARTIAL / FAIL verdict. +every file referenced in the `SKILL.md` body against the files packaged with the +skill, and returns a PASS / PARTIAL / FAIL verdict. ## Next steps From c396ed4690e7d6b3d8ceefed072ab6ef53f5e664 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 7 May 2026 18:19:27 +0000 Subject: [PATCH 4/5] Add upstream-release-docs content for toolhive-studio v0.34.0 --- SUMMARY.md | 12 ------------ 1 file changed, 12 deletions(-) delete mode 100644 SUMMARY.md diff --git a/SUMMARY.md b/SUMMARY.md deleted file mode 100644 index db9ac8b4..00000000 --- a/SUMMARY.md +++ /dev/null @@ -1,12 +0,0 @@ -# Summary of changes - -- Added a **Built-in agents** section in `docs/toolhive/guides-ui/playground.mdx` covering the **ToolHive Assistant** and the renamed **Skill Engineer** built-in agents (PR #2184). -- Added an **Enable installed skills** subsection in `docs/toolhive/guides-ui/playground.mdx` describing the new Skills picker on the composer toolbar (PR #2184). -- Updated the **Version** field copy in `docs/toolhive/guides-ui/skills-browse-install.mdx` to cover the new tag/digest auto-split behavior on paste (PR #2185). -- Added a **Build a skill from the Playground** section in `docs/toolhive/guides-ui/skills-build.mdx` and a new **Audit an installed skill** section in `docs/toolhive/guides-ui/skills-manage.mdx`, both pointing at the Skill Engineer agent. - -Skipped (no doc impact this release): - -- PR #2192 (chat virtualization) — internal performance change. -- PR #2206 (Flatpak Docker Desktop socket) — Flatpak isn't a documented install method. -- PR #2187 (skill deep-links) — broader `toolhive-gui://` deep-link surface isn't documented yet; covering only the new skill intents would be inconsistent. Worth a future follow-up. From 33a5ae47107ab75da9d67b8beaebbafe3f1c74ac Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Fri, 8 May 2026 12:05:10 +0000 Subject: [PATCH 5/5] Remove feature-flag-gated playground agent docs Agents mode and skill loading in the playground are behind a feature flag and not yet GA. Remove the Built-in agents section and Enable installed skills subsection from playground.mdx, the Build a skill from the Playground section from skills-build.mdx, and the Audit an installed skill section from skills-manage.mdx. Co-authored-by: Samuele V --- docs/toolhive/guides-ui/playground.mdx | 40 ----------------------- docs/toolhive/guides-ui/skills-build.mdx | 19 ----------- docs/toolhive/guides-ui/skills-manage.mdx | 9 ----- 3 files changed, 68 deletions(-) diff --git a/docs/toolhive/guides-ui/playground.mdx b/docs/toolhive/guides-ui/playground.mdx index 87408933..887443ad 100644 --- a/docs/toolhive/guides-ui/playground.mdx +++ b/docs/toolhive/guides-ui/playground.mdx @@ -93,45 +93,6 @@ To start using the playground: have access to all enabled MCP tools and can execute them based on your requests. -## Built-in agents - -The composer toolbar at the bottom of every chat thread includes an **Agent** -selector. ToolHive ships two built-in agents you can pick between, each with a -different system prompt and toolset: - -- **ToolHive Assistant**: a general-purpose assistant with access to every - enabled MCP tool. Use this for ad-hoc testing of MCP servers and for natural - language management of ToolHive itself (start/stop servers, inspect logs, and - similar tasks). -- **Skill Engineer**: a specialist for authoring and auditing - [agent skills](../concepts/skills.mdx). It can write a new `SKILL.md` plus - bundled files and build them into an OCI artifact through ToolHive's local - build API, or load an installed skill from disk and audit it against the spec. - -You can also create your own custom agents from **Playground** > **Agents** if -you want a different system prompt or model default. - -### Enable installed skills - -When you select the **Skill Engineer** agent, the composer toolbar shows a -**Skills** picker next to the **Agent**, **MCP Servers**, and **Model** -selectors. Use it to toggle which [installed skills](./skills-manage.mdx) are -visible to the agent in the current chat: - -- The dropdown lists every skill on the **Installed** tab, deduplicated by name - and tagged with a **User** badge or the project name to show each install - location. -- A count badge on the trigger shows how many skills are currently enabled. -- Selecting a skill exposes its `SKILL.md` and bundled files to the agent so it - can list, load, and read the contents on disk for an audit. -- **Clear enabled skills** disables every skill at once. Uninstalling a skill - from the **Skills** page also removes it automatically the next time the - picker refreshes. - -The picker is disabled for agents that don't have access to skill tools, such as -the default ToolHive Assistant. Switch to **Skill Engineer** or a custom agent -configured with the skills toolset to enable it. - ## Using the playground ### Testing MCP server functionality @@ -250,7 +211,6 @@ and identify any issues with tool implementation or configuration. when testing untrusted MCP servers - Browse the [registry](./registry.mdx) to discover new MCP servers to test in the playground -- [Build or audit a skill](./skills.mdx) with the **Skill Engineer** agent ## Related information diff --git a/docs/toolhive/guides-ui/skills-build.mdx b/docs/toolhive/guides-ui/skills-build.mdx index c97b1e02..278bd055 100644 --- a/docs/toolhive/guides-ui/skills-build.mdx +++ b/docs/toolhive/guides-ui/skills-build.mdx @@ -65,25 +65,6 @@ ToolHive deletes the artifact from the local OCI store. When multiple tags share the same digest, the underlying blobs are retained until every tag pointing to that digest is removed. -## Build a skill from the Playground - -If you'd rather draft a skill conversationally, switch the -[Playground](./playground.mdx#built-in-agents) agent to **Skill Engineer**. The -agent guides you through naming the skill, drafts the `SKILL.md` and any -supporting files inside the chat, and then calls ToolHive's local build API to -produce an OCI artifact. - -A successful build renders a "Skill built" card inline in the chat with three -actions: - -- **Install**: opens the **Install skill** dialog with the reference and version - pre-filled. -- **View details**: opens the build's row on the **Local Builds** tab. -- **Copy name**: copies the skill name to the clipboard. - -From there, the install and removal flows are identical to a build created from -the **Build skill** dialog. - ## Push a build to a remote registry Pushing to a remote container registry is currently a CLI-only operation. After diff --git a/docs/toolhive/guides-ui/skills-manage.mdx b/docs/toolhive/guides-ui/skills-manage.mdx index ce3c03d2..e3510632 100644 --- a/docs/toolhive/guides-ui/skills-manage.mdx +++ b/docs/toolhive/guides-ui/skills-manage.mdx @@ -45,15 +45,6 @@ again. ::: -## Audit an installed skill - -To inspect a skill's `SKILL.md` and bundled files without leaving the desktop -app, switch the [Playground](./playground.mdx#built-in-agents) agent to **Skill -Engineer**, enable the skill in the composer toolbar's **Skills** picker, and -ask the agent to audit it. The agent reads the on-disk install, cross-checks -every file referenced in the `SKILL.md` body against the files packaged with the -skill, and returns a PASS / PARTIAL / FAIL verdict. - ## Next steps - [Browse and install skills](./skills-browse-install.mdx) to add more skills