upgrade

Compare user data directories against a canonical plugin scaffold to detect structural drift.

1|1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/EqualsGroup/claude-executive-assistant --skill upgrade-equalsgroup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrade
Source: https://github.com/EqualsGroup/claude-executive-assistant/tree/main/skills/upgrade
Command: npx skills add https://github.com/EqualsGroup/claude-executive-assistant --skill upgrade-equalsgroup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structural drift accumulates as a plugin evolves: files, headings, registry entries, and directories in a user's EA data can diverge from the canonical scaffold, causing missing features, routing errors, and broken workflows. This Skill detects and reconciles those structural mismatches so the assistant can operate reliably against expected layouts.

Core Features & Use Cases

  • Scaffold comparison: Reads user data and scaffold templates in parallel to identify missing files, sections, and directory gaps.
  • CLAUDE.md registry and rule drift detection: Finds missing or outdated rules and memory registry entries and prepares safe updates.
  • Tiered remediation: Auto-applies safe structural fixes, proposes moves and migrations for approval, and reports issues for later action; ideal after plugin updates or periodic audits.

Quick Start

Run /upgrade to compare your EA_ROOT data against the plugin scaffold and apply safe structural fixes and proposed migrations.

Frequently Asked Questions about upgrade

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

FAQPage Schema
How do I detect structural drift in my plugin scaffold after an update?

Run a scaffold comparison to detect structural drift by reading user data and scaffold templates in parallel. It identifies missing files, sections, and directory gaps to ensure your data aligns with the canonical plugin layout.

Why does my CLAUDE.md registry have missing or outdated rules?

Your CLAUDE.md registry experiences drift as the plugin evolves, causing missing or outdated rules. A file audit reads your data root to find these registry mismatches and prepares safe updates to reconcile the structure.

What is the best way to reconcile user data directories against a canonical scaffold?

The best way to reconcile user data directories is through a read-only parallel analysis that identifies convention and registry drift. It produces tiered auto-fixes, proposed migrations, and a structured upgrade report for safe reconciliation.

Can I automatically apply structural fixes to my memory and sync directories?

Yes, you can automatically apply structural fixes through tiered remediation. The process auto-applies safe structural fixes, proposes moves and migrations for approval, and reports issues for later action across memory and sync directories.

When should I run a file audit for plugin migration and convention drift?

You should run a file audit for plugin migration and convention drift after plugin updates or during scheduled audits. This timing ensures your assistant data roots, including outputs and sync files, remain aligned with expected layouts.