Check Version
Fast plugin version check — compares installed version against GitHub in ~70ms.
Usage
bash <skill-path>/scripts/check-version.sh
Returns JSON:
{
"plugin": "bopen-tools",
"org": "b-open-io",
"local_version": "1.0.82",
"remote_version": "1.0.83",
"status": "outdated",
"message": "Update available: 1.0.82 -> 1.0.83. Run: claude plugin update bopen-tools@b-open-io"
}
Status Values
| Status | Meaning | Action |
|---|---|---|
current | Installed version matches GitHub | No action needed |
outdated | Newer version available on GitHub | Tell user to run the update command in the message field |
ahead | Local is newer than GitHub (dev environment) | No action needed |
not_installed | Plugin not found in cache | Tell user to install the plugin |
check_failed | Couldn't reach GitHub | Network issue — not critical, continue working |
When to Check
- At session start if you want to ensure you have latest agents/skills
- When a skill's behavior doesn't match its documentation
- When the user asks about updates
- Before giving advice about agent capabilities (outdated definitions could mislead)
The check is fast enough (~70ms) to run without noticeable delay. If status is outdated, tell the user and suggest the update command, but don't block on it — continue working with what's installed.