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.