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/