Skip to content

Quick Start

skillshub is a package manager for AI agent skills, similar to how Homebrew manages software on macOS but purpose-built for distributing and managing skills that extend AI agents. This guide walks you through the core workflow: adding a tap, finding skills, installing them, and linking them to your agent.

A tap is a repository of skill definitions. Before you can install any skills, you need to subscribe to at least one tap. The official community hub is a good place to start:

Terminal window
skillshub tap add brokad/hub

You can list all currently configured taps with:

Terminal window
skillshub tap list

To remove a tap you no longer need:

Terminal window
skillshub tap remove brokad/hub

Once you have a tap configured, you can search for skills by keyword:

Terminal window
skillshub search keyword

For example, to find skills related to code review:

Terminal window
skillshub search code-review

The output lists matching skills along with a short description and the tap they belong to. You can narrow results to a specific tap:

Terminal window
skillshub search code-review --tap brokad/hub

Install a skill by providing its fully qualified name in the form tap/skill:

Terminal window
skillshub install brokad/hub/my-skill

skillshub resolves the skill definition from the tap, downloads any required assets, and installs everything into its local store. You can install a specific version with the @ suffix:

Terminal window
skillshub install brokad/hub/my-skill@1.2.0

Installing a skill makes it available locally, but your AI agent needs to know about it. The link command connects all installed skills to a supported agent:

Terminal window
skillshub link claude

skillshub supports several agents. Pass the agent name that matches your setup:

Terminal window
skillshub link claude
skillshub link openai
skillshub link copilot

To unlink skills from an agent:

Terminal window
skillshub unlink claude

After linking, restart your agent or reload its configuration for the new skills to become available.

View everything currently installed on your system:

Terminal window
skillshub list

This displays each skill along with its version and the tap it was installed from. To get detailed information about a specific skill:

Terminal window
skillshub info brokad/hub/my-skill

Keep your skills up to date with a single command:

Terminal window
skillshub update

This refreshes all configured taps and upgrades every installed skill to its latest version. To update a single skill instead:

Terminal window
skillshub update brokad/hub/my-skill

To see which skills have updates available without applying them:

Terminal window
skillshub outdated

If you no longer need a skill, remove it with:

Terminal window
skillshub uninstall brokad/hub/my-skill

This removes the skill from your local store and automatically unlinks it from any connected agents.

Here is the full workflow from start to finish:

Terminal window
# Add the community tap
skillshub tap add brokad/hub
# Find a skill you need
skillshub search code-review
# Install it
skillshub install brokad/hub/code-review
# Connect it to your agent
skillshub link claude
# Verify it is installed
skillshub list

From here, you can explore more taps, install additional skills, and keep everything current with skillshub update.