richfrem/plugin-remover
plugins/plugin-manager/skills/plugin-remover/SKILL.md
Interactively select and uninstall agent plugins and skills from the local .agents/ environment.
$ install --global
skillsauthnpx skillsauth add richfrem/agent-plugins-skills plugin-removerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 7:40 AM54.7s4 files scanned
SKILL.md
- name:
- plugin-remover
- plugin:
- plugin-manager
- description:
- Interactively select and uninstall agent plugins and skills from the local .agents/ environment.
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.
Remove via GitHub (remote, no local clone required)
# 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-loops --yes
# Headless: remove all tracked plugins
uvx --from git+https://github.com/richfrem/agent-plugins-skills plugin-remove --all --yes
Remove via Local Path (development / offline)
# Interactive TUI from local clone
uvx --from . plugin-remove
# Headless: remove a specific plugin
uvx --from . plugin-remove --plugins agent-loops --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-loops --yes
python plugins/plugin-manager/scripts/plugin_remove.py --dry-run
What Removal Does
For each selected plugin, the uninstaller:
- Deletes the plugin directory/files from
.agents/skills/,.agents/workflows/,.agents/agents/,.agents/hooks/,.claude/,.gemini/, etc. - Removes the plugin entry from
plugin-sources.json(auto-update registry). - Removes the plugin entry from
skills-lock.json.
Dependencies
- Python 3.8+ (No external pip dependencies required).
plugin-sources.jsonmust exist and contain tracked plugins. Runplugin-addfirst.
Related Skills
richfrem/issue-worktree-agent
testing
VerifiedTrustedCommunity
Skill for creating and managing isolated git worktrees (`.worktrees/issue-NNN`) for issue execution branches. USE ONLY when setting up or cleaning up isolated git worktrees for specific issue execution. DO NOT USE for managing local task files (use `task-agent`) or escalating tasks to issues (use `github-issue-backlog-agent`).
4SKILL.mdUpdated Jul 29, 2026
richfrem/issue-pr-lifecycle-agent
data-ai
VerifiedTrustedCommunity
Skill for orchestrating the end-to-end GitHub issue lifecycle flow: Issue -> Worktree -> Implementation -> PR Creation -> Resolution Closure. USE ONLY when running or dry-running full lifecycle orchestration for resolving an issue with a PR. DO NOT USE for isolated worktree management only (use `issue-worktree-agent`) or logging issues (use `github-issue-agent`).
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-prioritizer
tools
VerifiedTrustedCommunity
Automatically ranks GitHub issues (P0-P3) based on friction tier, frequency, and blockages, synchronizing priority labels and GitHub Projects v2 custom fields.
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-backlog-agent
testing
VerifiedTrustedCommunity
Bridge skill for escalating ephemeral local task scratchpad items (`tasks/*.md`) into durable, taxonomy-validated, evidence-rich GitHub Issues. USE ONLY when promoting a single-session local task into durable repository backlog. DO NOT USE for managing local kanban boards (use `task-agent` instead) or directly querying/commenting on issues (use `github-issue-agent` instead).
4SKILL.mdUpdated Jul 29, 2026