skills.rest
richfrem
richfremCOMMUNITY
Explore all skills by this author →
GitHub

plugin-remover

Uninstall selected plugins and clean registries in .agents/ environments.

5|3|Updated Feb 21, 2026
Search Tags:#CLI#plugin#cleanup#interactive#registry#uninstall
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill plugin-remover
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-remover
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/plugin-manager/skills/plugin-remover
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill plugin-remover

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interactively select and uninstall agent plugins and skills from the local .agents/ environment, and ensure the canonical registries (plugin-sources.json and skills-lock.json) are updated accordingly.

Core Features & Use Cases

  • Executes deletions solely through the approved plugin_remove.py TUI to prevent orphaned files or incorrect removals.
  • Scrubs artifacts from multiple tracked locations including .agents/skills, .agents/workflows, .claude/, and .gemini/, ensuring a clean environment after uninstallation.
  • Keeps auto-update loops in sync by removing plugin entries from both plugin-sources.json and skills-lock.json when a plugin is removed.

Quick Start

Run the interactive plugin remover to uninstall a selected plugin and purge its traces from registries.

Frequently Asked Questions about plugin-remover

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

FAQPage Schema
How do I uninstall agent plugins and clean up the .agents environment?▼

To uninstall agent plugins, you interactively select target plugins to purge their artifacts from .agents/skills, .agents/workflows, .claude/, and .gemini/, ensuring a clean local environment post-removal.

Why do I have orphaned plugin files after manually removing agent skills?▼

Orphaned files occur when bypassing the approved workflow, which scrubs artifacts from multiple tracked locations and updates both plugin-sources.json and skills-lock.json to prevent registry desync.

Does the plugin removal process support batch uninstalling from skills-lock.json?▼

Yes, the plugin removal process handles single or batch removals, deleting artifacts and updating both skills-lock.json and plugin-sources.json to keep auto-update loops in sync.

Can I clean up .claude and .gemini plugin registries interactively?▼

Yes, you can clean up .claude/ and .gemini/ directories interactively, as the remover scrubs artifacts from these tracked locations and updates canonical registries during the uninstallation workflow.

What is the best way to prevent registry desync when removing local agent plugins?▼

The best way to prevent registry desync is executing deletions solely through the approved plugin_remove.py TUI, which safely removes plugin entries from plugin-sources.json and skills-lock.json.

Related Skills

Explore More Software Engineering Skills→
Aurora-AIAurora-AI

product-integrity-engineer

Diagnose divergences between PLAN.md and runtime outputs, then orchestrate repairs via Conductor and Archivist.

Community
Advanced
christophevgchristophevg

plugin-development

Scaffold Claude Code plugin structures with skills, agents, hooks, and MCP servers.

Community
Intermediate
ISAQQSAIISAQQSAI

clawdhub

Manage agent skills from clawdhub.com via the ClawdHub CLI.

Community
Advanced
epieczkoepieczko

docs.sync.pluginmanifest

Reconcile plugin.yaml with Betty Framework registries and generate preview and diff reports.

Community
Advanced