skillshub-cli
Command-line client for the Skills Hub agent-skill library
TLDR
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 --tagskills show skill
Show one skillskills search query [--limit n]
Search. --limit is a positive integerskills status skill
Deployment status for one skillskills check skill | --all
Validate one skill, or every skill with --allskills 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` commandskills 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 entryskills update skill | --all
Update from the recorded source. --all applies the batch after skills check --all. Update does not accept --dry-run or --yesskills adopt path [--dry-run | --yes]
Import an existing skills directory. Preview with --dry-run; apply with --yesskills remove skill [--dry-run | --yes]
Move a skill to the local recycle bin. Restore from the desktop appskills 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 tagagents list
List supported coding toolsdoctor
Check the CLI, library, and environmentversion
Print the CLI version. --json emits JSONsetup --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.
