Skip to main content

Manage installed skills

The Installed tab on the Skills page is the source of truth for every skill ToolHive has added to your AI clients. Use it to confirm a skill landed where you expected, see which clients received it, and remove it cleanly when you're done.

Open the Installed tab​

Open Skills from the menu bar, then select the Installed tab.

When the list is empty, the tab points you at the Registry tab to discover and install your first skill.

Use the controls in the top-right corner to:

  • Search: filter the list locally by name, namespace, or description.
  • Switch view: toggle between a card grid and a table. The view preference is remembered the next time you open the tab.

Read the installed skill cards​

Each card surfaces the metadata you need at a glance:

  • Name and namespace: the skill identifier.
  • Status badge: active, deprecated, or archived (case insensitive), as published by the source.
  • Scope badge: an icon and label for the install scope:
    • User scope (person icon): installed in your home directory and available across all projects.
    • Project scope (folder icon): scoped to a specific project folder.
  • Project root badge (project-scoped skills only): a monospace badge showing the last path segment, with a tooltip that reveals the full absolute path on hover.
  • Client badges: the AI clients ToolHive installed the skill for. Long lists collapse to the first three plus a +N badge that reveals the remaining clients in a tooltip.
  • Description: the first lines of the skill's description, clamped for layout. The full text lives on the detail page.

In table view, the same fields are spread across columns so you can sort and scan large lists. Click any row or card to open the detail page.

View installed skill details​

The detail page mirrors the registry layout: a left column with the skill identity, scope, clients, and source reference, and the rendered SKILL.md on the right. Use the Back button to return to the Installed tab.

Uninstall a skill​

To remove a skill, click the Uninstall action on any card, table row, or detail page and confirm the dialog.

ToolHive deletes the skill files from every associated client's skills directory and removes the database record. The change is reflected in the Installed tab immediately.

To reinstall the same skill later, head back to the Registry tab or to the Local Builds tab and click Install again. ToolHive treats it as a fresh install, so you can change scope or target clients at that point.

Reinstall to overwrite

The UI doesn't expose an explicit --force action like the thv skill install command. If you need to overwrite an existing install, uninstall the skill first and then install it again.

Next steps​

Troubleshooting​

An installed skill doesn't show up in my AI client

If your AI client doesn't list a skill from the Installed tab:

  1. Confirm the skill is installed for the right client. Open the detail page or check the client badges on the card.
  2. Confirm the scope matches where you're working. A Project scope skill only appears when the client is opened in that project folder; a User scope skill is global.
  3. Check the expected directory on disk. For example:
    • Claude Code: ~/.claude/skills/<SKILL_NAME>/ (user) or <PROJECT_ROOT>/.claude/skills/<SKILL_NAME>/ (project).
    • Cursor: ~/.cursor/skills/<SKILL_NAME>/ (user) or <PROJECT_ROOT>/.cursor/skills/<SKILL_NAME>/ (project).
  4. Restart your AI client so it rescans its skills directory.
Project-scope install fails with a Git error

ToolHive validates that the project root is a Git repository before writing skill files into it, to prevent installs in arbitrary folders.

  • Run git init in the project folder, or
  • Pick a folder that's already a Git repository, or
  • Install with User scope instead.
Uninstall removes the skill but the client still references it

Some AI clients cache their skills index on startup. After uninstalling, restart the client so it reloads the skills directory.

If the skill files are still present on disk, run thv skill list in a terminal to confirm ToolHive's view, then remove any leftover files manually.