Reference8 min read

Skills-Hub CLI

Install, search, publish, and manage skills directly from your terminal. Use it standalone or with npx, no global install required.

Installation

Run commands directly with npx (no install needed):

bash
npx @skills-hub-ai/cli <command>

Or install globally:

bash
npm install -g @skills-hub-ai/cli # provides the "skills-hub" command

Quick Start

bash
# Guided setup, shows platform, auth status, and popular skills
skills-hub init

# Authenticate (GitHub, Google, or email)
skills-hub login

# Search for skills
skills-hub search "code review"

# Install a skill
skills-hub install review-code

Skill Commands

install

Install a skill from skills-hub.ai into your project.

bash
skills-hub install <slug>

Options:
  -v, --version <version>   Install a specific version
  -t, --target <ids>        Install target(s), comma-separated. Defaults to
                            every detected platform on this machine.
  --all                     Install to every supported platform
  --team <org-slug>         Install from an organization
  --no-deps                 Skip installing composition dependencies

By default, skills-hub auto-detects every AI agent installed on your machine and writes SKILL.md to each. Pass --target with a comma-separated list to scope it, or --all to install everywhere. Run skills-hub list-platforms to see the full registry.

list-platforms

List every supported install target with detection status and target path.

bash
skills-hub list-platforms

Options:
  --json                    Output as JSON

search

Search the skill catalog.

bash
skills-hub search <query>

Options:
  -c, --category <slug>     Filter by category
  -s, --sort <field>        Sort: newest, most_installed, highest_rated
  -l, --limit <n>           Max results (default: 20)
  --org <slug>              Search within an organization

list

List locally installed skills.

bash
skills-hub list

info

Show detailed information about a skill.

bash
skills-hub info <slug>

Options:
  --json                    Output as JSON

update

Update installed skills to their latest versions.

bash
skills-hub update          # Update all
skills-hub update <slug>   # Update specific skill

uninstall

Remove a locally installed skill.

bash
skills-hub uninstall <slug>

categories

List all available skill categories.

bash
skills-hub categories

diff

Show the difference between two versions of a skill.

bash
skills-hub diff <slug> <from-version> <to-version>

install-bundle

Install all skills from a bundle in one command. Skips already-installed skills.

bash
skills-hub install-bundle <slug>

Options:
  -t, --target <target>     Install target: claude-code, cursor

Publishing

publish

Publish a skill from a SKILL.md file. Requires authentication.

bash
skills-hub publish [path]

Options:
  --draft                   Publish as draft (not publicly visible)
  --visibility <v>          public, unlisted, or private
  --org <slug>              Publish under an organization
  --tags <tags>             Comma-separated tags
  --github-repo <url>       Link to source repository

If no path is given, the CLI looks for SKILL.md in the current directory. See the Getting Started guide for the SKILL.md format.

version

Create a new version of an already-published skill.

bash
skills-hub version <slug> [path]

Options:
  --changelog <text>        Changelog entry for this version

unpublish

Archive a published skill (removes it from public listings).

bash
skills-hub unpublish <slug>

Authentication

login

Authenticate with skills-hub.ai. Opens a browser for OAuth by default.

bash
skills-hub login

Options:
  --provider <provider>     OAuth provider: github (default) or google
  --api-key <key>           Authenticate with an API key instead

You can also create an account with email/password at skills-hub.ai/auth/register.

API keys can be created in your account settings.

logout

Log out and clear stored credentials.

bash
skills-hub logout

whoami

Show the currently authenticated user.

bash
skills-hub whoami

Organizations

org create

Create a new organization.

bash
skills-hub org create <slug>

Options:
  --name <name>             Display name
  --description <text>      Organization description

org list

List organizations you belong to.

bash
skills-hub org list

org info

Show organization details.

bash
skills-hub org info <slug>

Options:
  --json                    Output as JSON
  --members                 Include member list

org invite

Invite a user to an organization.

bash
skills-hub org invite <org-slug> <username>

Options:
  --role <role>             admin, publisher, or member (default: member)

org remove

Remove a member from an organization.

bash
skills-hub org remove <org-slug> <username>

org leave

Leave an organization.

bash
skills-hub org leave <org-slug>

org sync

Sync organization members with a GitHub organization.

bash
skills-hub org sync <org-slug>

Options:
  --github-org <slug>       GitHub org to sync from
  --default-role <role>     Role for new members (default: member)

Framework Sync

sync

Export installed skills to a different framework format.

bash
skills-hub sync <framework>

Frameworks: openfang, mcp, codex, claude-code, cursor

Options:
  -o, --output <dir>        Output directory

Useful for migrating skills between tools or generating config for the OpenFang runtime.

generate

Generate SKILL.md files from an OpenAPI/Swagger specification. Creates one skill per endpoint.

bash
skills-hub generate --openapi <file>

Options:
  -o, --output <dir>        Output directory (default: ./skills)

Accepts JSON or YAML specs. Each generated skill includes endpoint details, parameters, auth requirements, and usage instructions.

Setup

init

Guided first-time setup. Shows your platform, auth status, installed skills, popular skills, and MCP setup instructions.

bash
skills-hub init

MCP Server

Serve installed skills as prompts in any MCP-compatible AI tool.

Claude Code

bash
claude mcp add skills-hub -- npx @skills-hub-ai/mcp

Cursor

Add to .cursor/mcp.json:

json
{
  "mcpServers": {
    "skills-hub": {
      "command": "npx",
      "args": ["@skills-hub-ai/mcp"]
    }
  }
}

The server scans ~/.claude/skills/ and ~/.cursor/skills/ for installed SKILL.md files and exposes each as an MCP prompt.

Configuration

Credentials and settings are stored in ~/.skills-hub/. Installed skills are saved per-project in your AI assistant's skill directory.

TargetSkill directory
Claude Code (claude-code)~/.claude/skills/
Cursor (cursor)~/.cursor/skills/
Codex CLI (codex)~/.codex/skills/
Gemini CLI (gemini)~/.gemini/skills/
GitHub Copilot (copilot).github/copilot/skills/
Windsurf (windsurf)~/.windsurf/skills/
Cline (cline)~/.cline/skills/
Roo Code (roo)~/.roo/skills/
Aide (aide)~/.aide/skills/
Augment (augment)~/.augment/skills/
Zed (zed)~/Library/Application Support/Zed/skills/ (macOS) or ~/.config/zed/skills/
Continue (continue)~/.continue/skills/
OpenCode (opencode)~/.opencode/skills/