plugin-remover · diff
git:20260831.b100768 to git:20260911.03c3cb8
19 added, 47 removed. Audit A to A.
---
name: plugin-remover
plugin: plugin-manager
description: Interactively select and uninstall agent plugins and skills from the local .agents/ environment.
+ allowed-tools: Bash, Read, Write
---
- # 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 manually `rm -rf` plugin 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.json` and `plugin-sources.json` to keep auto-update loops synchronized.
-
- ## Instructions
+ # Plugin Remover
- 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.
+ Safely uninstalls plugins from agent environments and synchronizes tracking registries.
- ### Remove via GitHub (remote, no local clone required)
+ ## Quick Start
+ ### 1. Interactive Removal (Recommended)
+ Launch the interactive removal menu:
```bash
- # Interactive TUI — lists all plugins tracked in plugin-sources.json
- uvx --from git+https://github.com/richfrem/agent-plugins-skills plugin-remove
-
- # Headless: remove a specific plugin without prompting
- uvx --from git+https://github.com/richfrem/agent-plugins-skills plugin-remove --plugins agent-orchestration/ --yes
-
- # Headless: remove all tracked plugins
- uvx --from git+https://github.com/richfrem/agent-plugins-skills plugin-remove --all --yes
+ python3 scripts/plugin_remove.py
```
- ### Remove via Local Path (development / offline)
-
+ ### 2. Headless Specific Removal
+ Remove a specific plugin without prompting:
```bash
- # Interactive TUI from local clone
- uvx --from . plugin-remove
-
- # Headless: remove a specific plugin
- uvx --from . plugin-remove --plugins agent-orchestration/ --yes
-
- # Or run the underlying Python script directly:
- python plugins/plugin-manager/scripts/plugin_remove.py
- python plugins/plugin-manager/scripts/plugin_remove.py --plugins agent-orchestration/ --yes
- python plugins/plugin-manager/scripts/plugin_remove.py --dry-run
+ python3 scripts/plugin_remove.py --plugins <plugin-name> --yes
```
- ### What Removal Does
-
- For each selected plugin, the uninstaller:
- 1. Deletes the plugin directory/files from `.agents/skills/`, `.agents/workflows/`, `.agents/agents/`, `.agents/hooks/`, `.claude/`, `.gemini/`, etc.
- 2. Removes the plugin entry from `plugin-sources.json` (auto-update registry).
- 3. Removes the plugin entry from `skills-lock.json`.
-
- ## Dependencies
+ ### 3. Full Cleanup (Remove All)
+ Remove all tracked plugins and clean orphaned artifacts:
+ ```bash
+ python3 scripts/plugin_remove.py --all --yes
+ ```
- - Python 3.8+ (No external pip dependencies required).
- - `plugin-sources.json` must exist and contain tracked plugins. Run `plugin-add` first.
+ ## Progressive Disclosure & References
+ - **CLI Reference & Cleanup Protocol**: See `references/remover-cli-guide.md` for registry scrubbing rules and orphan cleanup behavior.
+ - **Acceptance Criteria**: See `references/acceptance-criteria.md` for structural invariants.
+ - **Fallback Procedures**: See `references/fallback-tree.md` for fallback and recovery trees.