Skip to content

skillhub-club/cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@skill-hub/cli

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

npm version npm downloads

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

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

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
  --list-agents          List all supported agents

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

# 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

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

License

MIT © SkillHub

About

Cli to 1000x your agent capability

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published