$npx -y skills add QwenCloud/qwencloud-ai --skill qwencloud-update-check[QwenCloud] Check for qwencloud-ai updates and notify the user when a new version is available. TRIGGER when: user asks to check for updates, check version, asks 'is there a new version', 'latest version', 'update skills', 'check update', or any other qwen skill delegates to this
| 1 | # Qwen Update Checker |
| 2 | |
| 3 | Automatic version checker for the **qwencloud/qwencloud-ai** skill pack. Compares the locally installed version against the latest release on GitHub and notifies the user when an update is available. |
| 4 | |
| 5 | This skill is referenced by all other qwencloud/qwencloud-ai. When any skill runs, it checks if this skill is installed and delegates version checking here. |
| 6 | |
| 7 | ## How It Works |
| 8 | |
| 9 | 1. Reads the installed version from `version.json` (the `version` field bundled with this skill). |
| 10 | 2. Fetches the latest version from the remote repository (GitHub raw content). |
| 11 | 3. Compares versions using semver. Returns `{"has_update": true}` if a newer version exists. |
| 12 | 4. Records the check timestamp (`last_interaction`) in `<repo_root>/.agents/state.json` to rate-limit network requests to once every 24 hours. |
| 13 | |
| 14 | ## Usage |
| 15 | |
| 16 | Other skills invoke this script automatically. You can also run it manually: |
| 17 | |
| 18 | ```bash |
| 19 | python3 <path-to-this-skill>/scripts/check_update.py --print-response |
| 20 | ``` |
| 21 | |
| 22 | ### CLI Arguments |
| 23 | |
| 24 | | Argument | Description | |
| 25 | |----------|-------------| |
| 26 | | `--print-response` | Print result as formatted JSON to stdout | |
| 27 | | `--force` | Bypass 24-hour rate limit and check immediately | |
| 28 | |
| 29 | ### Output Format |
| 30 | |
| 31 | ```json |
| 32 | { |
| 33 | "has_update": true |
| 34 | } |
| 35 | ``` |
| 36 | |
| 37 | ## Configuration |
| 38 | |
| 39 | | Environment Variable | Default | Description | |
| 40 | |---------------------|---------|-------------| |
| 41 | | `QWEN_SKILLS_REPO` | `qwencloud/qwencloud-ai` | GitHub repo for remote version check | |
| 42 | |
| 43 | ## State File |
| 44 | |
| 45 | The `last_interaction` timestamp is stored at `<repo_root>/.agents/state.json` for rate-limiting. Check results are **not** cached in the state file. This file persists across sessions and is shared with `gossamer.py` for fatigue control. |