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 in the right scope and on the right clients, and to remove skills you no longer need.

Find an installed skill​

  1. Open Skills from the menu bar, then select the Installed tab.
  2. Type in the search box to filter the list locally by name, namespace, or description.
  3. Click any row or card to open the detail page for the full SKILL.md and the install metadata.

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

Each card and table row surfaces the context you need to confirm an install: the skill's name and namespace, its scope (User or Project), the AI clients that received it, and (for project-scoped skills) the project root path.

Uninstall a skill​

Click Uninstall 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 Installed tab updates immediately.

To reinstall the same skill later, return to the Registry tab or 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. 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.