Enable, disable, or delete AI agent skills — across all your agents, from one panel.
Skills Switch is a lightweight CLI tool that gives you a visual control panel for all your AI agent skills. It doesn't install anything, doesn't connect to any marketplace — it scans what's already on your disk and lets you enable, disable, or delete skills across 16 agents from a single browser window.
There are dozens of "skill manager" tools that help you browse marketplaces and install new skills. But nobody talks about what happens after you've installed 30 of them — your agent context gets bloated, prompts get slower, and you have no easy way to temporarily turn things off.
Skills Switch is the off button. It's for the moment when you think "I don't need the Jira integration right now, let me just disable it" — and you want that to take one click, not a terminal command.
- On/Off toggles — enable or disable any skill with one click (renames the directory with a
.disabledsuffix) - Delete with confidence — remove skills from individual agents, or wipe them across all agents at once
- 16 agents supported — Claude Code, Cursor, Codex, Copilot, Windsurf, Gemini CLI, Cline, and more
- Global + per-project views — manage globally installed skills and project-scoped skills side by side
- "All agents" view — see which skills are installed across multiple agents at a glance
- Zero configuration — run
npx skills-switchand a browser tab opens. That's it.
npx skills-switchA local server starts and your browser opens automatically. Click the toggles. Done.
If you'd rather install globally:
npm install -g skills-switch
skills-switchThe panel has three areas:
| Area | What it does |
|---|---|
| Left sidebar | Switch between Global skills and per-project skills. Use "Add Project" to add any directory on your machine. |
| Top agent tabs | Filter skills by agent. "All" shows every skill across every agent, with labels showing where each one is installed. |
| Skill cards | Each card shows the skill name, description, and a toggle switch. The trash icon deletes the skill (with confirmation). |
Skills Switch uses a simple convention: a skill directory named my-skill is enabled; my-skill.disabled is disabled. Most agents respect this naming convention, which means toggling a skill here has immediate effect the next time you use that agent.
| Agent | Global skills location |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ |
| Cursor | ~/.agents/skills/ |
| Gemini CLI | ~/.agents/skills/ |
| GitHub Copilot | ~/.agents/skills/ |
| Cline | ~/.agents/skills/ |
| OpenCode | ~/.agents/skills/ |
| Kimi Code CLI | ~/.agents/skills/ |
| Warp | ~/.agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ |
| Goose | ~/.config/goose/skills/ |
| Continue | ~/.continue/skills/ |
| Roo Code | ~/.roo/skills/ |
| Trae | ~/.trae/skills/ |
| Trae CN | ~/.trae-cn/skills/ |
| Qwen Code | ~/.qwen/skills/ |
Note on
~/.agents/skills/: Several agents share this canonical directory. The official Anthropic skills CLI installs skills here so they're available to all compatible agents at once. Skills Switch scans this directory for every agent that uses it — if a skill lives here, it shows up under Codex, Cursor, Copilot, and every other universal agent automatically.
Skills Switch is a local web app — nothing leaves your machine.
npx skills-switch
→ starts Express server on localhost
→ scans skill directories on your disk
→ opens the control panel in your browser
- Scanning: reads
SKILL.mdfiles from each agent's skills directory to build the skill list - Toggling: renames directories —
my-skill↔my-skill.disabled - Deleting: removes directories with
fs.rmSync. A "thorough" mode also cleans up symlinks and cross-agent copies. - Adding projects: session-only (resets on restart). Project skills are at
<project>/.agents/skills/and<project>/<agent>/skills/.
Agent definitions live in src/agents.ts. Each entry needs:
{
id: "agent-id",
displayName: "Agent Name",
globalSkillsDirs: [path.join(HOME, ".agent", "skills")],
homeDirMarker: path.join(HOME, ".agent"),
}To find the correct skill directories for a new agent, check the official Anthropics skills repository — specifically src/agents.ts. It defines skillsDir (project scope) and globalSkillsDir (global scope) for 50+ agents, and is the authoritative reference.
Key things to check when adding an agent:
- Universal vs. non-universal: If the agent's
skillsDiris.agents/skills, add~/.agents/skills/as the first entry inglobalSkillsDirs. This is the canonical directory shared by multiple agents. - Detection: Set
homeDirMarkerto a directory that only exists when the agent is installed. - Priority: Put the canonical/shared directory first, agent-specific directories second. The scanner deduplicates by name and keeps the first match.
git clone https://github.com/user/skills-switch.git
cd skills-switch
npm install
cd web && npm install && cd ..
# Terminal 1: backend dev server
npm run dev
# Terminal 2: frontend dev server (with hot reload)
npm run dev:web
# Build for production
npm run build- Backend: Node.js + Express + TypeScript (
src/) - Frontend: React + Vite + TypeScript + Tailwind CSS (
web/) - Design: Claude.com design system — Cormorant Garamond display serif, Inter body, warm cream canvas, coral accents
MIT