# Skillhub CLI

Connect an Agent to a SkillHub registry and use the official SkillHub CLI to search...

- Repository: https://github.com/iflytek/skillhub (5351 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add iflytek/skillhub --skill skillhub-cli -g -a claude-code -y`
Codex: `npx skills add iflytek/skillhub --skill skillhub-cli -g -a codex -y`
Cursor: `npx skills add iflytek/skillhub --skill skillhub-cli -g -a cursor -y`
Gemini CLI: `npx skills add iflytek/skillhub --skill skillhub-cli -g -a gemini-cli -y`

## Description

Connect an Agent to a SkillHub registry and use the official SkillHub CLI to search, install, list, or explicitly upgrade SkillHub skills. Use when a user asks to connect SkillHub, install a SkillHub skill, or manage skills previously installed from SkillHub.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# SkillHub CLI

Use the registry that supplied this guide to connect the current Agent and manage SkillHub packages with the first-party `@astron-team/skillhub` CLI.

## Resolve The Registry

Resolve `<registry>` once before composing commands. For an already installed Skill, use the `registry` recorded in its sibling `.skillhub/metadata.json`; that source is authoritative for later searches and upgrades. Otherwise resolve in this order:

1. the absolute HTTP(S) registry explicitly selected by the user, including the base URL obtained by removing the trailing `/registry/skill.md` from the URL used to fetch this guide;
2. `SKILLHUB_REGISTRY`;
3. the `registry` field in `~/.skillhub/config.json`;
4. `https://skill.xfyun.cn`.

Use only an absolute HTTP(S) URL. Treat `<registry>` below as a value to replace, not shell syntax or an environment variable.

Keep the exact registry selected by the user for the current request. Do not change their configured default registry for a one-off operation, and do not send a private search query to another registry without approval.

## Use The First-Party CLI

First determine whether `skillhub` exists on `PATH`. On POSIX shells use `command -v skillhub`; in PowerShell use `(Get-Command skillhub -ErrorAction SilentlyContinue).Source`. If the command is missing, install the latest first-party CLI globally so future manual `skillhub` commands use this implementation:

```bash
npm install --global @astron-team/skillhub
skillhub version
```

If the command exists, do not run the global installation or update yet because its package-manager shim could overwrite the existing launcher. Inspect the existing command without changing anything: resolve the exact command selected by the shell, follow symlinks to the final target, and identify its owner and installing package manager or package. Run `skillhub version` as an additional compatibility check, not as proof of ownership. Do not infer identity from the command name or output alone.

The rest: https://github.com/iflytek/skillhub/blob/HEAD/builtin-skills/skills/skillhub-cli/SKILL.md