# Check Version

> Compare installed plugin versions against GitHub to confirm skills and agents are current. Use at session start, for "is everything up to date", "are my plugins up to date", "are our plugins current", "check for plugin updates", "is anything stale", "am I on the latest version", "did that plugin update land", or when a skill behaves differently than documented or references features you do not recognize. Checks any plugin in the marketplace, not just core. Completes in under 100ms per plugin.

- Skill: `b-open-io-prompts/check-version` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add b-open-io-prompts/check-version`
- Raw SKILL.md: https://api.skillmd.com/api/skills/b-open-io-prompts/check-version/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: b-open-io (https://skillmd.com/u/b-open-io-prompts)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/b-open-io-prompts/check-version

---


# Check Version

Fast plugin version check — compares installed version against GitHub in ~70ms.

## Usage

```bash
bash <skill-path>/scripts/check-version.sh
```

Returns JSON:

```json
{
  "plugin": "core",
  "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 core@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.