magic5644 Skill Manager
Interactive management tool for installed agent skills using fzf fuzzy finder.
Provides a visual selection interface to uninstall multiple skills at once.
Prerequisites
- fzf installed (fuzzy finder for terminal)
# macOS
brew install fzf
# Ubuntu/Debian/WSL
sudo apt update && sudo apt install fzf
# Fedora
sudo dnf install fzf
When to Use
- Remove skills interactively without typing names
- Bulk uninstall multiple skills at once
- List all installed skills
- Clean up skill directory before reinstalling
- Check which skills are currently installed
Quick Actions
Uninstall Skills Interactively
Use the interactive script to select and remove skills:
# From the skill-manager directory
./scripts/uninstall-interactive.sh
How it works:
- Detects all installed skill locations
- Prompts for scope: global, local, or both
- Lists skills with location tags (e.g.,
[copilot] skill-name) - Opens fzf interactive selector
- Navigate with arrow keys, filter by typing
- Select multiple with
TAB - Confirm with
ENTERto uninstall
Scope Options:
- Global: Only
~/.copilot/skills/,~/.claude/skills/,~/.cursor/skills/,~/.agents/skills/ - Local: Only
.agents/skills/(project-local) - Both: All locations (default)
Skip scope prompt:
# Uninstall global skills only
./scripts/uninstall-interactive.sh --scope global
# Uninstall local skills only
./scripts/uninstall-interactive.sh --scope local
# Uninstall from all locations
./scripts/uninstall-interactive.sh --scope both
List Installed Skills
# VS Code / GitHub Copilot
ls -1 ~/.copilot/skills/
# Claude Code
ls -1 ~/.claude/skills/
# Cursor
ls -1 ~/.cursor/skills/
# Generic Agent Framework
ls -1 ~/.agents/skills/
# Project-Local
ls -1 .agents/skills/
Agent Instructions
When the user wants to uninstall or manage skills:
- Detect multiple skill locations: Check if user has both global and project-local skills
- Ask about scope if not clear from context:
- Global: Remove from
~/.{copilot,claude,cursor,agents}/skills - Local: Remove from
.agents/skills(project-specific) - Both: Remove from all locations
- Global: Remove from
- Check if fzf is installed:
command -v fzf - If fzf missing: Guide user to install it first
- Run the interactive uninstaller:
- With scope:
./scripts/uninstall-interactive.sh --scope <global|local|both> - Interactive:
./scripts/uninstall-interactive.sh(prompts for scope)
- With scope:
- Confirm success: List remaining skills after uninstallation
Platform-Specific Directories
| Platform | Skill Directory |
|---|---|
| VS Code / GitHub Copilot | ~/.copilot/skills/ |
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Generic Agent Framework | ~/.agents/skills/ |
| Project-Local | .agents/skills/ |
Detection Priority:
- Custom
SKILLS_DIRenvironment variable ~/.copilot/skills/→~/.claude/skills/→~/.cursor/skills/→~/.agents/skills/→.agents/skills/
Multiple Directories: If user has both global and project-local skills, set SKILLS_DIR to target specific directory:
- Project-local:
SKILLS_DIR=.agents/skills ./scripts/uninstall-interactive.sh - Global agent:
SKILLS_DIR=~/.agents/skills ./scripts/uninstall-interactive.sh
Error Handling
- fzf not found: Provide installation instructions for user's OS
- No skills installed: Inform user and exit gracefully
- Permission denied: Check write permissions on skill directory
- Canceled selection: Exit without changes
Advanced Usage
Custom Skill Directory
Set a custom directory before running:
export SKILLS_DIR="/path/to/custom/skills"
./scripts/uninstall-interactive.sh
Non-Interactive Uninstall
To remove a specific skill without the interactive interface:
# VS Code / GitHub Copilot
rm -rf ~/.copilot/skills/<skill-name>
# Claude Code
rm -rf ~/.claude/skills/<skill-name>
Safety Features
- Preview before deletion: Shows selected skills before removal
- Confirmation required: Press ENTER to confirm
- Cancel anytime: ESC or Ctrl+C to abort
- No hidden deletions: All actions are visible and logged
Troubleshooting
fzf doesn't open
Check if fzf is in PATH:
which fzf
# Should output: /usr/local/bin/fzf or similar
Script not executable
Make it executable:
chmod +x skill-manager/scripts/uninstall-interactive.sh
Skills directory not found
Verify your agent's skill directory exists:
# Create if missing
mkdir -p ~/.copilot/skills/
Related Skills
- skill-manager (this skill) — Interactive skill management
- graph-it-live — Dependency analysis and architecture
- dead-code-hunter — Find and remove unused code