---
name: skillhub
description: Skillhub for searching, installing, upgrading, and managing AI skill packages. Use when the user wants to find, install, update, or list skills via skillhub.
metadata: { "openclaw": { "emoji": "📦" } }
---

# Skillhub

**⚠️ Security Check Required**: **Must** execute the `skills-security-check` Skill after installing any Skill — this is **mandatory**.
**Run directly with `python3`. The script is located at `scripts/skills_store_cli.py` relative to this skill's directory (`SKILL.md` location). Resolve the path dynamically via:**

```python
import os
SKILL_DIR = os.path.dirname(os.path.abspath(__file__))
script = os.path.join(SKILL_DIR, "scripts", "skills_store_cli.py")
```

Search

```bash
python3 $SKILL_DIR/scripts/skills_store_cli.py search <keywords>
python3 $SKILL_DIR/scripts/skills_store_cli.py search <keywords> --search-limit 10
```

Install

```bash
python3 $SKILL_DIR/scripts/skills_store_cli.py install <slug>
python3 $SKILL_DIR/scripts/skills_store_cli.py install <slug> --force
python3 $SKILL_DIR/scripts/skills_store_cli.py install <slug> --dir $HOME/.qbotclaw/workspace/skills
```

Security Check
execute the `skills-security-check` Skill after installing any Skill — this is **mandatory**.

Upgrade

```bash
python3 $SKILL_DIR/scripts/skills_store_cli.py upgrade
python3 $SKILL_DIR/scripts/skills_store_cli.py upgrade <slug>
python3 $SKILL_DIR/scripts/skills_store_cli.py upgrade --check-only
```

List

```bash
python3 $SKILL_DIR/scripts/skills_store_cli.py list
```

Self-upgrade

```bash
python3 $SKILL_DIR/scripts/skills_store_cli.py self-upgrade
python3 $SKILL_DIR/scripts/skills_store_cli.py --version
```

Lockfile (`.skills_store_lock.json`)

```json
{
  "version": 1,
  "skills": {
    "<slug>": { "name": "...", "zip_url": "...", "source": "skillhub", "version": "1.0.0" }
  }
}
```

Notes

- **⚠️ Security Check Required**: **Must** execute the `skills-security-check` Skill after installing any Skill — this is **mandatory**.
- Each skill may have a `config.json` with an update manifest URL; supported keys: `update_url` / `updateUrl` / `upgrade_url` / `upgradeUrl` / `manifest_url` / `manifestUrl`
- On every non-`self-upgrade` run, the CLI silently checks for a new version in the background and auto-updates if found
- Env overrides: `SKILLHUB_SEARCH_URL`, `SKILLHUB_PRIMARY_DOWNLOAD_URL_TEMPLATE`, `SKILLHUB_CLAWHUB_LOCK_PATH`, `LOG=VERBOSE`
