check-versionlisted
Install: claude install-skill produtoramaxvision/maxvision
# Check version
Argument: $ARGUMENTS — component id (skill or subagent name) and optional `--force-check` flag.
## Cache layout
- File: `~/.claude/cache/maxvision/version-check.json`
- Schema:
```json
{
"$schema_version": "1.0.0",
"entries": {
"<component_id>": {
"kind": "plugin|skill|agent",
"local_sha": "abc...",
"remote_sha": "def...",
"last_check_iso": "2026-04-28T14:32:11Z",
"ttl_seconds": 3600,
"source_repo": "owner/repo",
"source_branch": "main",
"status": "up_to_date|stale|missing"
}
}
}
```
## Workflow
### 1. Parse args
- Extract the component id (first non-flag token).
- Detect `--force-check` flag (ignores cache).
### 2. Cache lookup (skip if `--force-check`)
```bash
set -euo pipefail
mkdir -p ~/.claude/cache/maxvision
test -f ~/.claude/cache/maxvision/version-check.json || echo '{"$schema_version":"1.0.0","entries":{}}' > ~/.claude/cache/maxvision/version-check.json
```
Read the entry. If `last_check_iso` is within `ttl_seconds` from now, **return cached result** with note `(from cache, age=<N>min)`.
### 3. Resolve component → source
Determine `kind` and `source_repo`:
- **Plugin install:** look up `~/.claude/plugins/installed_plugins.json` for `<plugin>@<marketplace>` entries. The `gitCommitSha` is the local sha. The marketplace's `extraKnownMarketplaces[<marketplace>].source.repo` from `~/.claude/settings.json` is the upstream repo.
- **Manually-cloned ski