Skip to content

Commit c221e6f

Browse files
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 <noreply@anthropic.com>
1 parent a141f79 commit c221e6f

4 files changed

Lines changed: 28 additions & 24 deletions

File tree

docs/toolhive/guides-ui/playground.mdx

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -114,24 +114,23 @@ you want a different system prompt or model default.
114114
### Enable installed skills
115115

116116
When you select the **Skill Engineer** agent, the composer toolbar shows a
117-
**Skills** picker next to the Agent / MCP Servers / Model selectors. Use it to
118-
toggle which [installed skills](./skills-manage.mdx) are visible to the agent in
119-
the current chat:
117+
**Skills** picker next to the **Agent**, **MCP Servers**, and **Model**
118+
selectors. Use it to toggle which [installed skills](./skills-manage.mdx) are
119+
visible to the agent in the current chat:
120120

121121
- The dropdown lists every skill on the **Installed** tab, deduplicated by name
122-
and annotated with **User** or `<PROJECT_NAME>` badges that show each install
122+
and tagged with a **User** badge or the project name to show each install
123123
location.
124-
- A live count badge on the trigger reflects how many skills are currently
125-
enabled.
124+
- A count badge on the trigger shows how many skills are currently enabled.
126125
- Selecting a skill exposes its `SKILL.md` and bundled files to the agent so it
127126
can list, load, and read the contents on disk for an audit.
128-
- **Clear enabled skills** wipes the allow-list. Uninstalling a skill from the
129-
**Skills** page also removes it automatically the next time the picker
130-
refreshes.
127+
- **Clear enabled skills** disables every skill at once. Uninstalling a skill
128+
from the **Skills** page also removes it automatically the next time the
129+
picker refreshes.
131130

132-
The picker is greyed out for agents that don't bind the skills toolset (such as
133-
the default ToolHive Assistant). Switch to **Skill Engineer** or any custom
134-
agent that binds the skills tool bundle to enable it.
131+
The picker is disabled for agents that don't have access to skill tools, such as
132+
the default ToolHive Assistant. Switch to **Skill Engineer** or a custom agent
133+
configured with the skills toolset to enable it.
135134

136135
## Using the playground
137136

docs/toolhive/guides-ui/skills-browse-install.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,12 +42,12 @@ The **Install skill** dialog asks for:
4242
`ghcr.io/<OWNER>/skills/<SKILL_NAME>:<TAG>`).
4343
- A Git URL of the form `git://host/owner/repo[@ref][#path/to/skill]`.
4444

45-
- **Version** (optional) - prefilled automatically when you open the dialog from
46-
a registry skill or local build. If you paste a tagged or digest-pinned
45+
- **Version** (optional) - pre-filled automatically when you open the dialog
46+
from a registry skill or local build. If you paste a tagged or digest-pinned
4747
reference into the **Reference** field (for example, `my-skill:v1.0.0` or
4848
`ghcr.io/<OWNER>/skills/<NAME>@sha256:<DIGEST>`), ToolHive splits the suffix
49-
into the **Version** field when you tab out, so you don't have to break the
50-
reference up by hand. Leave the field blank to install the latest version.
49+
into the **Version** field when you tab out, so you don't have to split it
50+
manually. Leave the field blank to install the latest version.
5151

5252
- **Scope** (required) - where the skill files are written on disk. Hover the
5353
**(i)** icon next to the field to see the inline tooltip:

docs/toolhive/guides-ui/skills-build.mdx

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -68,14 +68,19 @@ that digest is removed.
6868
## Build a skill from the Playground
6969

7070
If you'd rather draft a skill conversationally, switch the
71-
[Playground](./playground.mdx) agent to **Skill Engineer**. The agent guides you
72-
through naming the skill, drafts the `SKILL.md` and any supporting files inside
73-
the chat, and then calls ToolHive's local build API to produce an OCI artifact.
71+
[Playground](./playground.mdx#built-in-agents) agent to **Skill Engineer**. The
72+
agent guides you through naming the skill, drafts the `SKILL.md` and any
73+
supporting files inside the chat, and then calls ToolHive's local build API to
74+
produce an OCI artifact.
7475

7576
A successful build renders a "Skill built" card inline in the chat with three
76-
actions: **Install** (opens the **Install skill** dialog with the reference and
77-
version pre-filled), **View details** (deep-links to the build on the **Local
78-
Builds** tab), and **Copy name** (copies the bare skill name to the clipboard).
77+
actions:
78+
79+
- **Install**: opens the **Install skill** dialog with the reference and version
80+
pre-filled.
81+
- **View details**: opens the build's row on the **Local Builds** tab.
82+
- **Copy name**: copies the skill name to the clipboard.
83+
7984
From there, the install and removal flows are identical to a build created from
8085
the **Build skill** dialog.
8186

docs/toolhive/guides-ui/skills-manage.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,8 @@ To inspect a skill's `SKILL.md` and bundled files without leaving the desktop
5151
app, switch the [Playground](./playground.mdx#built-in-agents) agent to **Skill
5252
Engineer**, enable the skill in the composer toolbar's **Skills** picker, and
5353
ask the agent to audit it. The agent reads the on-disk install, cross-checks
54-
every file the body references against what's actually packaged, and returns a
55-
PASS / PARTIAL / FAIL verdict.
54+
every file referenced in the `SKILL.md` body against the files packaged with the
55+
skill, and returns a PASS / PARTIAL / FAIL verdict.
5656

5757
## Next steps
5858

0 commit comments

Comments
 (0)