@skill-hub/cli

One-command install for AI agent skills - Install skills to Claude, Cursor, Codex, and 6+ more agents instantly

Core Features

One-Command Install

Install any skill to your AI agent with a single command - just like npx skills add:

npx @skill-hub/cli install frontend-design --agent claude

Supports 9+ Agent Platforms:

• Claude Code, Cursor, Codex, Gemini, GitHub Copilot
• Windsurf, Cline, Roo Code, OpenCode

Smart Discovery

Find the perfect skill with semantic search, trending lists, and AI-powered recommendations:

# Semantic search
npx @skill-hub/cli search "react best practices"

# Trending skills (24h)
npx @skill-hub/cli trending

# Latest additions
npx @skill-hub/cli latest

# Personalized recommendations
npx @skill-hub/cli recommend --task frontend

Skill Management

Create, publish, and manage your own skills:

# Create a new skill
npx @skill-hub/cli init

# Publish to SkillHub
npx @skill-hub/cli publish

# Sync with remote
npx @skill-hub/cli push

Installation

Two ways to use:

Option 1: Using npx (Recommended) ⭐

No installation needed - always uses the latest version:

npx @skill-hub/cli install frontend-design
npx @skill-hub/cli search "react"

Pros:

• No installation required
• Always uses latest version
• No global package pollution
• Works immediately

Option 2: Global Installation

Install once, use skillhub command directly:

npm install -g @skill-hub/cli

# Then use shorter command
skillhub install frontend-design
skillhub search "react"

Pros:

• Shorter command (skillhub vs npx @skill-hub/cli)
• Faster (no download on each run)
• Works offline after installation

Note: After global install, use skillhub instead of npx @skill-hub/cli

The CLI checks npm before every command. If a newer release exists, it automatically hands the command to the exact newer @skill-hub/cli release; if npm is unavailable or the updated process does not start within 30 seconds, the installed version continues normally. The handoff forwards only the SkillHub/provider and operating-system environment variables the CLI needs, not unrelated cloud credentials. Set SKILLHUB_DISABLE_AUTO_UPDATE=1 only when an offline or pinned environment must skip this check.

Quick Start

1. Install a Skill

# Using npx (no install needed)
npx @skill-hub/cli install frontend-design --agent claude

# Or if globally installed, use shorter command
skillhub install frontend-design --agent claude

# Install to project directory
skillhub install frontend-design --project

# Interactive mode (choose agent & location)
skillhub install frontend-design

# RedSkill distribution: resolve and privately import; install only if already approved
skillhub install redskill:bigw-skill-2 --agent openclaw

# Search upstream RedSkill metadata
skillhub search "文档" --registry redskill

redskill:<identifier> is a distribution reference, not an agent name. The default flow previews the upstream metadata, imports a fork for normalization and a pending security review, and only installs when an exact canonical artifact is already approved. Login is required for the import step.

In the initial rollout, uncurated RedSkill imports remain private and pending. Automatic installation becomes available only after SkillHub links a separately reviewed canonical artifact and the full-artifact security service approves it.

Installation Locations:

• Personal (Global): ~/.claude/skills/ - Available for all projects
• Project: ./.claude/skills/ - Only for current project

2. Discover Skills

# Search with natural language
skillhub search "react component design"

# Browse trending (24h)
skillhub trending --limit 20

# See what's new
skillhub latest

# Get AI recommendations
skillhub recommend --task frontend --query "component library"

3. Create & Publish

# Login first
skillhub login

# Initialize a skill project
skillhub init

# Edit SKILL.md, then push
skillhub push

# Make it public
skillhub publish

All Commands

Discover & Install

| Command | Aliases | Description | |---------|---------|-------------| | install <skill> | i, add | Install a skill to your agent | | search <query> | s, find | Semantic search for skills | | trending | hot, popular | Show trending skills (24h) | | latest | new, recent | Show recently added skills | | recommend | rec, suggest | Get personalized recommendations | | top | leaderboard, rank | Show all-time leaderboard |

Create & Manage

| Command | Description | |---------|-------------| | login | Log in to SkillHub | | init | Initialize a new skill project | | push | Push local files to remote | | pull | Pull remote files to local | | status | Show local vs remote status | | publish | Publish skill to public directory | | list | List your skills | | whoami | Show current logged in user |

Install Command

Basic Usage

# Using npx
npx @skill-hub/cli install <skill-slug> [options]

# Or if globally installed
skillhub install <skill-slug> [options]

Options

Options:
  -a, --agent <agent>    Target agent (claude, cursor, codex, gemini, copilot, windsurf, cline, roo, opencode)
  -p, --project          Install to project directory (default: personal)
  -d, --dir <path>       Custom install directory
  -y, --yes              Skip confirmation prompts
  --accept-risk          Explicitly accept a caution security decision (separate from --yes)
  --native               Print a manual RedSkill command; never execute it
  --list-agents          List all supported agents

--native only prints redskill install <identifier> and warns that the manual upstream path bypasses SkillHub's artifact security gate. It never runs a shell or installs the RedSkill CLI.

Supported Agents

| Agent | Command | Install Path | |-------|---------|--------------| | Claude Code | claude | ~/.claude/skills/ | | Cursor | cursor | ~/.cursor/skills/ | | Codex CLI | codex | ~/.codex/skills/ | | Gemini CLI | gemini | ~/.gemini/skills/ | | GitHub Copilot | copilot | ~/.copilot/skills/ | | Windsurf | windsurf | ~/.windsurf/skills/ | | Cline | cline | ~/.cline/skills/ | | Roo Code | roo | ~/.roo/skills/ | | OpenCode | opencode | ~/.config/opencode/skills/ |

Examples

Install Examples

# Quick install to Claude
skillhub install frontend-design --agent claude -y

# Legacy S0 review: explicitly acknowledge the displayed caution
skillhub install frontend-design --agent claude --accept-risk

# Install to Cursor project
skillhub install frontend-design --agent cursor --project

# Interactive install (choose agent & location)
skillhub install anthropics-skills-frontend-design

Discovery Examples

# Search and install
skillhub search "react" --limit 5
skillhub install anthropics-skills-frontend-design

# Browse trending
skillhub trending --limit 20 --category development

# Get recommendations
skillhub recommend --task backend --query "API design"

Management Examples

# Create and publish a skill
skillhub login
skillhub init
# Edit SKILL.md...
skillhub push
skillhub publish

# Check status
skillhub status
skillhub list

Why SkillHub CLI?

One Command, Any Agent

Unlike other tools, install skills to 9+ different AI agents with the same command.

Smart Discovery

Semantic search powered by embeddings - find skills by what they do, not just keywords.

Trending & Recommendations

Discover what's popular and get personalized recommendations based on your needs.

Fast & Simple

No complex setup - just npx and go. Works offline after installation.

Secure

OAuth authentication, no API keys in code, credentials stored securely.

Configuration

User Config

Stored in ~/.skillhub/config.json:

• API URL (default: https://skillhub.club/api/v1)
• Default visibility settings

Auth Tokens

Stored securely in ~/.skillhub/auth.json (mode 600):

• Access tokens
• Refresh tokens
• User info

Local Project Config

Each skill project has .skillhub.json:

• Skill metadata
• Remote sync info
• Ignore patterns

Privacy-friendly telemetry

The CLI sends bounded anonymous command outcomes and RedSkill funnel stages. It never sends command arguments, search prompts, local paths, file contents, or raw error messages. The same random local attribution ID is used for CLI and API observations so aggregate events can be joined without an account identifier.

Set SKILLHUB_TELEMETRY=off, SKILLHUB_TRACKING=false, or DO_NOT_TRACK=1 to opt out. When disabled, the CLI creates no telemetry identity, sends no direct telemetry, and asks SkillHub API routes not to record server-side analytics.

Development

# Clone
git clone https://github.com/skillhub-club/cli.git
cd cli

# Install
npm install

# Build
npm run build

# Dev mode (watch)
npm run dev

# Type check
npm run typecheck

Links

• Website: https://skillhub.club
• Documentation: https://skillhub.club/docs
• npm: https://www.npmjs.com/package/@skill-hub/cli
• GitHub: https://github.com/skillhub-club/cli
• Issues: https://github.com/skillhub-club/cli/issues

License

MIT © SkillHub