plugin-uninstall

Uninstall EvoNexus plugins by removing files, clearing hooks, and running uninstall SQL.

520|175|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/evolution-foundation/evo-nexus --skill plugin-uninstall
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-uninstall
Source: https://github.com/evolution-foundation/evo-nexus/tree/main/.claude/skills/plugin-uninstall
Command: npx skills add https://github.com/evolution-foundation/evo-nexus --skill plugin-uninstall

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users uninstall an EvoNexus plugin by reverting all files it installed and running the plugin’s uninstall SQL to clear associated runtime hooks.

Core Features & Use Cases

  • Reverts installed plugin files: Removes workspace artifacts created by the plugin, including agent/rule/command documents and Claude hook handlers.
  • Executes uninstall lifecycle cleanly: Deletes the plugin via the API and runs the plugin’s uninstall.sql plus pre/post uninstall hook scripts.
  • Protects against accidental data loss: Requires explicit confirmation and warns that plugin-managed table data is often dropped by uninstall, offering disable or export alternatives.
  • Use case: You no longer need a plugin for a past workflow and want to fully remove it without leaving behind heartbeats, routines, or hook handlers.

Quick Start

Ask an assistant to uninstall plugin X (for example, "uninstall plugin my-plugin") and confirm the removal when prompted.

Frequently Asked Questions about plugin-uninstall

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

FAQPage Schema
How do I safely uninstall an EvoNexus plugin and clean up workspace files?

To safely uninstall an EvoNexus plugin, the process removes installed agent, rule, and command documents, clears heartbeats and hook handlers, and runs uninstall SQL to revert the workspace state via the API.

What happens to my database data when I remove a plugin?

When you remove a plugin, the uninstall SQL often drops plugin-managed table data. The process requires explicit confirmation to prevent accidental data loss and suggests exporting data or disabling the plugin as alternatives.

How does plugin uninstall handle dependencies and rollback?

Plugin uninstall handles dependencies by resolving the plugin slug and executing reverse-order dependency rollback, ensuring that dependent components are properly managed before completely removing the target plugin files.

What HTTP errors might I encounter when deleting a plugin via the API?

When deleting a plugin via the API, the uninstall process safely handles HTTP 404, 409, and 500 error states, managing issues like missing plugins, conflicts, or internal server errors during the deletion request.

Can I just disable a plugin instead of fully uninstalling it?

Yes, you can disable a plugin instead of fully uninstalling it. Disabling avoids dropping plugin-managed table data, making it a safer alternative if you want to prevent data loss while stopping the plugin's runtime routines.

Does uninstalling a plugin remove Claude hook handlers and heartbeats?

Yes, uninstalling a plugin removes Claude hook handlers and clears heartbeats. The process executes pre and post uninstall hook scripts to ensure operational routines and workspace artifacts are completely cleaned up.