Uninstall Skill

Safely removes installed Claude tools (skills, agents, commands) from global or project locations.

Quick Reference

Command	Action
/uninstall	Interactive uninstall wizard
/uninstall list	Show installed tools

Workflow

Handling "list" Argument

If the user runs /uninstall list, skip the interactive workflow and show installed tools for both locations:

python {SKILL_DIR}/uninstall.py --target global --list
python {SKILL_DIR}/uninstall.py --target project --list

Step 1: Choose Target Location

Use AskUserQuestion to ask:

Where do you want to uninstall from?

• Global (~/.claude/) - Tools available in all projects
• Project (.claude/) - Tools only in current project

Step 2: Show Installed Tools

Run the discovery script:

python {SKILL_DIR}/uninstall.py --target <choice> --list

This shows all installed tools with their components and installation mode (symlink/copy).

Step 3: Select Tools to Remove

If there are installed tools:

1. Display them as a numbered list
2. Ask the user to enter tool numbers (e.g., "1,2" or "all")
3. Parse the response and map numbers back to tool names

If no tools are installed, inform the user and end the workflow.

Step 4: Execute Uninstall

Run the uninstall with user choices:

python {SKILL_DIR}/uninstall.py --target <choice> --tools <tool1,tool2,...>

Step 5: Report Results

Show the user what was removed:

• Skills removed from {target}/skills/{tool_name}/
• Agents removed from {target}/agents/
• Commands removed from {target}/commands/

Example Session

User: /uninstall

[Uses AskUserQuestion for target selection]

User selects: Global

[Runs: python uninstall.py --target global --list]

Claude: Installed tools in ~/.claude:
  1. brainstorm - skills/brainstorm/ (symlink), 3 agents
  2. viz        - skills/viz/ (symlink)

Enter tool numbers to uninstall (e.g., 1,2 or 'all'):

User enters: 1

Claude: Uninstalling brainstorm...

[Runs: python uninstall.py --target global --tools brainstorm]

Removing brainstorm...
  Unlinked skills/brainstorm/
  Unlinked agents/pragmatic-explorer.md
  Unlinked agents/creative-challenger.md

Uninstall complete!

Safety Features

• Only operates on ~/.claude/ or .claude/ directories
• Only removes tools that exist in the repository (known tools)
• Validates target paths before any deletion
• Handles both symlinks and copied files appropriately
• Skips tools that aren't installed (no-op, not an error)

Notes

• Uninstalling removes the tool from the target location only
• The source files in the repository are never modified
• Re-install anytime using /install