Run idempotent forward migrations to match the canonical plugin.json version.
npx skills add https://github.com/Cain-Ish/claude-code-plugin --skill upgrade-cain-ish
Please help me install this Agent Skill. Skill: upgrade Source: https://github.com/Cain-Ish/claude-code-plugin/tree/main/skills/upgrade Command: npx skills add https://github.com/Cain-Ish/claude-code-plugin --skill upgrade-cain-ish
This Skill eliminates the confusion and breakage risk of mismatched plugin versions by safely detecting drift and applying only the missing forward migrations, so your local second-brain setup stays consistent after updates.
Run the upgrade skill to migrate your local installation to the currently declared plugin version and update the installed-version marker.
High-intent search queries and answers about installing and using this skill.
To safely migrate local state after a plugin upgrade, run a forward-only migration runner that compares the installed version against the canonical plugin.json version and applies only the missing idempotent migrations.
Idempotent version migration works by reading the current and installed versions, deciding which migration targets fall in the missing range, and executing explicit checks before updating the installed-version marker so the process can be repeated safely without duplicate work.
You need to run forward migrations for your plugin after pulling a new release to ensure the installed state matches the canonical version, applying additive feature migrations and cache refresh validation to prevent mismatched versions.
The best way to handle version mismatches in a local second-brain setup is to apply safe, idempotent forward migrations that guard optional features and include validation gates like verifying vector-deps import capability before updating the installed-version marker.
Yes, you can safely enable optional features like the knowledge graph during a plugin upgrade because the migration process applies forward-only, minimal-impact additive changes and guards optional features so upgrades remain safe and reversible.
Yes, an idempotent migration runner skips work if the plugin state is already satisfied by including idempotent health checks that verify capabilities like vector-deps imports and skip redundant migrations when already up to date.
LiorCohenCompare installed and project plugin versions and output a mismatch report.
ignromanovMigrate wiki schemas across plugin version upgrades with backups and validation.
RayzerrekManage Unity Package Manager install, remove, refresh, search, and inspection operations.
psd401Analyze Claude Code changelogs to map release changes into plugin upgrade plans.
