uninstall

Removes installer-owned agents and startup configuration while preserving edited user files.

4|1|Updated Jul 31, 2025
One-click install
npx skills add https://github.com/alvis/.agents --skill uninstall-alvis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uninstall
Source: https://github.com/alvis/.agents/tree/main/plugins/essential/skills/uninstall
Command: npx skills add https://github.com/alvis/.agents --skill uninstall-alvis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Removing an installed agent team by hand risks deleting files the user edited or leaving orphaned configuration behind. This Skill reverses an Essential installation safely by consulting the recorded ownership manifest instead of guessing which files belong to the installer. ## Core Features & Use Cases - Ownership-based removal: Uses the .essential/ ownership record as the sole authority, removing only files whose content still matches the installed hash and preserving anything the user modified. - Harness-aware targeting: Supports claude, codex, and grok runtimes with correct default agent destinations, and detaches the Grok bootstrap attachment from the user AGENTS.md without touching surrounding text. - Idempotent and recoverable: Repeated runs are harmless, shared support files are retained while preserved agents need them, and unresolved entries are kept for a later retry. - Use Case: After evaluating the marketplace in a Grok environment, run the uninstall to remove the installed agent team and its startup guidance while keeping your custom rules and any agents you edited. ## Quick Start Ask the assistant to uninstall the Essential agent installation for the current harness, for example by saying "uninstall the Essential agents from my Grok setup and keep my edited files".

Frequently Asked Questions about uninstall

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

FAQPage Schema
How do I uninstall agents installed by the Essential plugin?

Run the uninstall script with your harness name, for example bash scripts/uninstall.sh --harness grok. It reads the .essential/ ownership record at the agent destination and removes only files that still match their installed content hash.

Will uninstalling delete agent files I have edited?

No. The uninstaller compares each recorded file against its installed hash and preserves any file whose content changed. Modified files are reported as preserved, and shared support files are retained while preserved agents still need them.

Does the uninstaller work with Claude Code, Codex, and Grok?

Yes, pass --harness claude, codex, or grok to select the runtime. Defaults are ~/.claude/agents, ${CODEX_HOME:-$HOME/.codex}/agents, and ${GROK_HOME:-$HOME/.grok}/agents. OpenCode installations are managed by its V1 projector instead.

What happens if the ownership record is missing during uninstall?

Without the .essential/ ownership record at the destination, the uninstaller removes nothing. Ownership is never inferred from familiar agent names, and a record is never regenerated to authorize deletion.

Does uninstalling remove the marketplace plugin itself?

No. This Skill only removes installed agent files and, for Grok, the recorded bootstrap attachment in AGENTS.md. Plugin removal is a separate operation performed through the harness's plugin manager.