Skip to main content

Manage agent skills

Agent skills are reusable bundles of instructions, scripts, and resources that teach AI agents how to perform specific tasks. Where MCP servers expose tools (the raw capabilities your agent can call), skills package the knowledge of when, why, and how to use those tools to get a job done.

The ToolHive UI gives you one place to discover skills, install them for the AI clients you've registered, and build your own from a local folder. ToolHive takes care of writing the skill files into the right directory for each client and tracks every install so you can update or remove it cleanly.

New to skills?

If you're not sure what a skill is or how it relates to MCP servers, see Understanding skills for a conceptual overview.

The Skills page​

Open the Skills page from the menu bar to access three tabs:

  • Registry: browse skills from the configured registry, search and filter the catalog, and install a skill in one click.
  • Installed: see every skill ToolHive has installed for your AI clients, inspect its scope and target clients, and uninstall it.
  • Local Builds: list OCI artifacts you've built locally from a folder on your machine, install them into a client, or remove them from your local store.

You can switch each tab between a card grid and a table using the view toggle in the top-right corner. Your preference is remembered per tab.

Each skill detail page shows the rendered SKILL.md content alongside a summary panel with action buttons, so you can read what a skill does before installing it.

Where to start​

Prefer the command line?

Every action on the Skills page is also available through the thv skill command, including pushing local builds to a remote OCI registry.