skhub

The official CLI for Agent Skill Hub. Install and manage reusable AI agent skills and skillsets in your project or globally.

Requirements

• Node.js 20 or newer

Installation

npm install --global skhub

Or run it without installing:

npx skhub <command>

Quick start

# Install a skill
skhub add <username/skill>

# Install a skillset
skhub add --skillset @username/skillset

# List installed skills
skhub list

# Search public skills
skhub search <query>

# Check one project scope, then the global scope
skhub doctor
skhub doctor --global

Skills are recorded in skills.json at the detected project root and installed into .agents/skills. Use --target claude or --target both to install for Claude Code as well. With --target both, --link-mode symlink means Link intent: skhub prefers a relative symbolic link and may use a Windows directory junction. Use --link-mode copy when .claude needs an independent real directory. Add --global to use the global manifest at ~/.skhub/skills.json.

skhub never falls back to copy silently. Interactive add and link can ask once before mutation. For unattended operations, use the explicit copy mode for add or link, or pass --allow-copy to sync, update, and doctor --fix to authorize fallback while still preferring Link.

Do not downgrade to a CLI version that predates --link-mode while copy-mode installs are present. Older versions can replace the .claude copy with a symlink during sync or update, discarding changes made only in that copy.

Commands

| Command | Description | | ------------------- | ------------------------------------------------------------- | | add | Install a skill, skillset, or GitHub repository | | list | List installed skills | | remove | Remove an installed skill | | sync | Reinstall the versions recorded in the manifest | | link | Normalize unmanaged .agents and .claude skills | | update | Update installed skills and sync skillsets | | dash | Open the localhost dashboard for global skills | | doctor | Check one scope's manifests, Links, copies, and files offline | | search / find | Search public skills | | create --skillset | Create a skillset from installed skills | | login | Sign in through the browser | | whoami | Show the current account | | logout | Sign out |

Run skhub <command> --help for command options. Full documentation is available at doc.agentskillhub.dev.

Local dashboard

skhub dash
skhub dash --no-open
skhub dash --port 7542

dash starts a foreground server on 127.0.0.1 and presents the global manifest, installed files, unmanaged directories, and doctor findings in a local browser UI. The API uses a new in-memory token on every run. Stop the server with Ctrl+C.

Configuration

• SKHUB_API_URL overrides the API base URL.
• The default API is https://agentskillhub.dev.

Development

pnpm install
pnpm dev:cli -- --help
pnpm test:cli
pnpm build:cli

License

Copyright © Agent Skill Hub. All rights reserved.

This package is proprietary and is not open source. No permission is granted to copy, modify, distribute, or use this software except as authorized by Agent Skill Hub.