LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

skillshub-cli

Command-line client for the Skills Hub agent-skill library

TLDR

Print the version as JSON
$ skillshub-cli --json version
copy
List installed skills
$ skillshub-cli --json skills list
copy
Search the library
$ skillshub-cli --json skills search "[testing]"
copy
Install a skill from Git or a local path
$ skillshub-cli --json skills install [https://github.com/owner/repo]
copy
Install from a subdirectory of that source
$ skillshub-cli --json skills install [https://github.com/owner/repo] --subpath [path/to/skill]
copy
Deploy a skill to Codex (preview first)
$ skillshub-cli --json skills deploy [SKILL_ID] --agent codex --dry-run
copy
Apply that deployment
$ skillshub-cli --json skills deploy [SKILL_ID] --agent codex
copy
Check the install and library
$ skillshub-cli --json doctor
copy
List supported agents
$ skillshub-cli --json agents list
copy

SYNOPSIS

skillshub-cli [--json] [--lang en|zh-CN|ko] command [options]

DESCRIPTION

skillshub-cli is the standalone CLI for Skills Hub, a library that installs Agent Skills once and deploys them into the global (or project) skills directories of AI coding tools. Write commands talk to the real desktop library; they are not a simulation. The desktop app is a separate Tauri GUI; this binary is `src-tauri/src/bin/skillshub-cli.rs`.The clap program name is skillshub-cli. Top-level commands are skills, agents, doctor, version, and setup. A hidden __bridge command is for the desktop app. Color is always off. There is no `help` subcommand; use -h / --help. Linux standalone builds need glibc 2.39 or later. The installer writes `~/.local/bin/skillshub-cli` and verifies a SHA-256 checksum. Node.js is not required.

PARAMETERS

--json

Machine-readable output. Global; may sit before the subcommand
--lang en|zh-CN|ko
Message language. Global
-h, --help
Print usage
-V, --version
Print the clap version and exit (same crate version as version)

COMMANDS

skills list [--tag tag] [--source source] [--agent agent] [--untagged] [--status status]

List library entries. --tag, --source, and --agent are repeatable. --untagged conflicts with --tag
skills show skill
Show one skill
skills search query [--limit n]
Search. --limit is a positive integer
skills status skill
Deployment status for one skill
skills check skill | --all
Validate one skill, or every skill with --all
skills install source [--subpath path]
Add a skill from a Git URL or local path. --subpath selects a directory inside that source. There is no `collections install` command
skills deploy skill --agent name [--project path] [--dry-run]
Copy the skill into a tool's skills directory. --agent is required and repeatable. --project is an absolute project path on macOS/Linux. undeploy takes the same flags and removes the copy while keeping the library entry
skills update skill | --all
Update from the recorded source. --all applies the batch after skills check --all. Update does not accept --dry-run or --yes
skills adopt path [--dry-run | --yes]
Import an existing skills directory. Preview with --dry-run; apply with --yes
skills remove skill [--dry-run | --yes]
Move a skill to the local recycle bin. Restore from the desktop app
skills tag add | remove | set skill tag [tag ...]
Change tags on one skill. list [skill] lists tags. rename old new renames a tag. delete tag [--dry-run | --yes] deletes a tag
agents list
List supported coding tools
doctor
Check the CLI, library, and environment
version
Print the CLI version. --json emits JSON
setup --agent name [--remove] [--dry-run] [--yes]
Install or remove the official AI-management skill for a tool. --agent is required and repeatable. --yes is only valid with --remove

CAVEATS

The CLI shares the desktop library. Device sync, authorization, schedules, settings, app updates, and recycle-bin restore stay in the GUI. OPERATION_BUSY means another write is in progress. TARGET_CONFLICT needs a review of tool-target clashes. CONFIRMATION_REQUIRED and PLAN_STALE mean preview again before --yes. Do not pass tokens on the command line. Standalone installs from `install-cli.sh` are separate from the desktop-managed CLI; rerun the script to upgrade. CLI release assets exist from v0.11.0.

HISTORY

Skills Hub is an MIT-licensed Tauri app by GitHub user qufei1993. Desktop v1.0.0 is the current major release. Collections live in the sibling awesome-skills repository.

SEE ALSO

git(1), claude(1), cursor(1)

RESOURCES

Copied to clipboard
Kai