CLI Reference

The skills-hub CLI lets you 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):

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

Or install globally:

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

Quick Start

# 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.

skills-hub install <slug>

Options:
  -v, --version <version>   Install a specific version
  -t, --target <target>     Install target: claude-code (default), cursor
  --team <org-slug>         Install from an organization
  --no-deps                 Skip installing composition dependencies

Skills are saved to .claude/skills/ for Claude Code or .cursor/skills/ for Cursor.

search

Search the skill catalog.

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.

skills-hub list

info

Show detailed information about a skill.

skills-hub info <slug>

Options:
  --json                    Output as JSON

update

Update installed skills to their latest versions.

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

uninstall

Remove a locally installed skill.

skills-hub uninstall <slug>

diff

Show the difference between two versions of a skill.

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

install-bundle

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

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.

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.

skills-hub version <slug> [path]

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

unpublish

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

skills-hub unpublish <slug>

Authentication

login

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

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.

skills-hub logout

whoami

Show the currently authenticated user.

skills-hub whoami

Organizations

org create

Create a new organization.

skills-hub org create <slug>

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

org list

List organizations you belong to.

skills-hub org list

org info

Show organization details.

skills-hub org info <slug>

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

org invite

Invite a user to an organization.

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

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

org remove

Remove a member from an organization.

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

org leave

Leave an organization.

skills-hub org leave <org-slug>

org sync

Sync organization members with a GitHub organization.

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.

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.

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.

skills-hub init

MCP Server

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

Claude Code

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

Cursor

Add to .cursor/mcp.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.

Target	Skill directory
Claude Code	`.claude/skills/`
Cursor	`.cursor/skills/`