session-plugin-refresh

Re-reads skills and references after a plugin update and reconciles prior session actions against the new text.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/hacker-cb/claude-code-plugins --skill session-plugin-refresh-hacker-cb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-plugin-refresh
Source: https://github.com/hacker-cb/claude-code-plugins/tree/main/plugins/hcb-dev/skills/session-plugin-refresh
Command: npx skills add https://github.com/hacker-cb/claude-code-plugins --skill session-plugin-refresh-hacker-cb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When a Claude Code plugin is updated mid-session, the session keeps acting under the old skill and reference text it was loaded with. This Skill re-reads the current files, diffs them against the version the session was running, and reconciles everything the session already did against what the files now say. ## Core Features & Use Cases - Version Resolution: Runs a Node.js script that reports the loaded, installed, floor, and upstream plugin versions as key=value lines, degrading every unresolvable value to unknown with a reason instead of failing. - Full Re-read with Diff: Diffs the floor tree against the installed tree's skills/ and references/ directories, then reads every skill and the transitive closure of named references in full. - Divergence Reconciliation: Classifies each divergence between past actions and new rules as repaired, standing, owed, or escalated to the addressee, and emits a ranked report. - Use Case: After the user says "the plugin was updated", invoke this Skill to detect that the installed tree moved from 1.2.0 to 1.3.0, re-read the changed skills, repair a ledger section that no longer matches the required shape, and notify parallel batch sessions that their plugin moved too. ## Quick Start Tell the assistant the plugin was updated and ask it to re-read the skills and references and reconcile what this session already did against the new versions.

Frequently Asked Questions about session-plugin-refresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refresh a Claude Code session after a plugin update?▼

Invoke the session-plugin-refresh skill after reporting that the plugin was updated. It runs plugin-versions.mjs to resolve the loaded and installed versions, diffs the skill and reference trees, re-reads every file in full, and reports what changed and what the session must now do differently.

Does this skill install or update the plugin itself?▼

No. It only re-reads files and reports differences. Installing or updating a plugin and running /reload-plugins remain the user's actions; the skill never executes them and says so explicitly in its report.

What happens if the plugin version cannot be resolved?▼

The version script prints unknown with a reason key instead of failing, and the re-read proceeds anyway. The user's word that the plugin moved is the trigger; version numbers only inform the report, never gate the reading.

Can it reconcile actions taken under the old plugin version?▼

Yes. It reviews what the session wrote, sent, decided, and left standing against the new text, classifying each divergence as repaired, standing, owed, or needing the addressee's decision, and records the reconciled version as the floor for the next refresh.

Why does the skill say hooks and MCP servers keep the old version?▼

Reading the installed tree by path fixes only the current session's instructions. Hooks, MCP servers, and monitors keep the path they loaded until the user runs /reload-plugins or restarts, which the skill reports but never runs itself.