| namespace | aiwg |
| name | uninstall-plugin |
| platforms | ["all"] |
| description | Remove a previously installed Claude Code marketplace plugin and unregister it from the local plugin registry |
Uninstall Plugin
You remove a previously installed Claude Code marketplace plugin. In AIWG vocabulary, the plugin is the delivery wrapper; the deployed files are its extension, addon, or framework payload. You remove deployed files and unregister the wrapper from the local plugin registry.
Triggers
Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):
- "get rid of the voice plugin" → uninstall voice@aiwg
- "I don't need the marketing kit anymore" → uninstall marketing@aiwg
- "clean up the SDLC agents" → uninstall sdlc@aiwg
- "remove everything from that plugin" → uninstall with cleanup
Trigger Patterns Reference
| Pattern | Example | Action |
|---|
| Uninstall plugin | "uninstall plugin voice@aiwg" | Run aiwg uninstall-plugin voice@aiwg |
| Remove plugin | "remove plugin marketing@aiwg" | Run aiwg uninstall-plugin marketing@aiwg |
| Plugin uninstall | "plugin uninstall sdlc@aiwg" | Run aiwg uninstall-plugin sdlc@aiwg |
| Dry run | "what would removing the voice plugin delete?" | Run aiwg uninstall-plugin voice@aiwg --dry-run |
| Keep artifacts | "remove the plugin but keep my .aiwg/ files" | Run aiwg uninstall-plugin sdlc@aiwg --keep-artifacts |
Behavior
When triggered:
-
Extract intent:
- Which plugin is being removed?
- Is this a dry run (preview) or should changes be applied?
- Should project artifacts in
.aiwg/ be preserved? (default: yes, always preserve)
-
Run the appropriate command:
aiwg uninstall-plugin sdlc@aiwg
aiwg uninstall-plugin voice@aiwg
aiwg uninstall-plugin marketing@aiwg
aiwg uninstall-plugin sdlc@aiwg --dry-run
aiwg uninstall-plugin sdlc@aiwg --keep-artifacts
-
Report the result — list what was removed (agents, commands, skills, rules) and confirm the marketplace wrapper is deregistered.
What Gets Removed
| Removed | Description |
|---|
| Agent files | Files in .claude/agents/ that belong to the plugin |
| Command files | Files in .claude/commands/ that belong to the plugin |
| Skill files | Files in .claude/skills/ that belong to the plugin |
| Rule files | Files in .claude/rules/ that belong to the plugin |
| Registry entry | Delivery-wrapper entry removed from local plugin registry |
What Is NOT Removed
| Preserved | Reason |
|---|
.aiwg/ project artifacts | These are your project output, not marketplace package files |
| Shared skills used by other packages | Removed only when the last dependent package is removed |
| Custom modifications to deployed package files | Files modified after install are flagged, not deleted |
Examples
Example 1: Remove the voice plugin
User: "Uninstall the voice plugin"
Extraction: Plugin name is voice@aiwg
Action:
aiwg uninstall-plugin voice@aiwg
Response: "Uninstalled voice@aiwg. Removed 6 voice profiles from .claude/skills/voices/, 4 soul system skills, 2 rules. Plugin deregistered."
Example 2: Dry run before removing
User: "What would removing the SDLC plugin delete?"
Extraction: Dry-run for sdlc plugin
Action:
aiwg uninstall-plugin sdlc@aiwg --dry-run
Response: "Dry run — uninstalling sdlc@aiwg would remove: 58 agents from .claude/agents/, 42 commands from .claude/commands/, 12 skills, 33 rules. Your .aiwg/ project artifacts would NOT be affected. No changes made."
Example 3: Plugin not found
User: "Remove the analytics plugin"
Extraction: Plugin name analytics — not in registry
Action:
aiwg uninstall-plugin analytics@aiwg
Response: "Plugin analytics@aiwg is not installed. Run aiwg plugin-status to see what is currently installed."
Clarification Prompts
If the plugin name is ambiguous or not clearly installed:
- "Which plugin would you like to remove? Installed plugins: sdlc@aiwg, voice@aiwg. Run
aiwg plugin-status to confirm."
References
- @$AIWG_ROOT/src/cli/handlers/utilities.ts — Command handler
- @$AIWG_ROOT/docs/cli-reference.md — CLI reference
