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.