plugin-remover
Installation
SKILL.md
Plugin Remover Skill
Overview
This skill orchestrates the safe, interactive removal of plugins from the local agent environment and updates the canonical tracking registries (plugin-sources.json and skills-lock.json).
By relying on the plugin_remove.py TUI, this skill ensures that no ghost files, orphaned symlinks, or stale hook registrations remain after a plugin is uninstalled.
Key Architecture Rules
- Execution: All deletions must be run transparently through
plugin_remove.py. Do NOT attempt to manuallyrm -rfplugin directories directly from.agents/. - Target Folders: Artifacts are automatically scrubbed from
.agents/skills,.agents/workflows,.claude/,.gemini/, etc. - Registries: The uninstaller automatically parses and scrubs the removed plugin from both
skills-lock.jsonandplugin-sources.jsonto keep auto-update loops synchronized.
Instructions
Whenever the user asks to "remove a plugin", "uninstall a skill", or "delete a plugin", guide them to use the interactive TUI or run headless via flags.