What problem does it solve?
This Skill detects and cleans up redundant copies of the metaswarm framework that were embedded into a project by the npm installer, replacing them with the marketplace plugin equivalents while ensuring no project-specific data is lost.
Core Features & Use Cases
- Safe discovery and pre-flight checks: verifies plugin presence, distribution setting, and uncommitted changes before proceeding.
- Content-verified cleanup: inventories candidate files and compares SHA-256 normalized contents against the plugin to identify unmodified framework copies for removal while flagging user-modified files.
- Reversible git operations and shims: stages removals with git rm, offers explicit undo instructions, creates thin command shims routing to the plugin, and updates .metaswarm/project-profile.json to record the migration.
- Use Case: migrate a repository initialized with npx metaswarm that contains an embedded .claude/plugins/metaswarm copy so the project uses the marketplace plugin without losing custom project files.
Quick Start
Run the migration skill to stage cleaning up redundant metaswarm framework copies while preserving and never touching your project-specific files.