cli · context management

Every skill you install loads into every session.

Claude Code injects the name and description of every installed skill into every session — before you type a word. Skillswitch disables the ones the current task doesn't need, and saves the sets as profiles you switch with one command.

npm install -g skillswitch
View source on GitHub →
npm versionnpm downloads per monthGitHub stars
the problem
skills installed100
tokens per skill entry (name + description)~40
tokens injected per session, before your first message~4,000

~40 tokens per entry is an estimate — the exact cost depends on your descriptions. skillswitch status shows how many skills you actually have active. More skills means worse signal-to-noise and less room for your actual work.

how it works

Disable what you don't need, snapshot the result as a profile, switch profiles as the task changes.

$skillswitch disable --plugin aso-skills@aso-skills
$skillswitch disable ads
$skillswitch profile create dev
$skillswitch profile use dev
Profile "dev" active. Only its skills load in the next session.
01

skillswitch disable <name>

Turn off what the task doesn’t need. Substring match; --plugin disables whole plugins.

02

skillswitch profile create dev

Snapshot the current enabled set as a named profile.

03

skillswitch profile use dev

Switch sets with one command. --dry-run previews the change first.

what actually happens on disk

standalone skills — moved to a .disabled/ subdirectory — nothing deleted, enable moves them back

plugin skills — written to Claude Code's own plugins/blocklist.json

profiles — plain JSON in ~/.claude/skillctl/profiles.json — no telemetry, no network, no auth

commands
skillswitch detect# which AI CLIs are installed
skillswitch status# active vs disabled counts
skillswitch list# all skills by source
skillswitch disable <name># disable a skill (or --plugin <id>)
skillswitch enable <name># re-enable it
skillswitch profile create <name># snapshot current enabled set
skillswitch profile use <name># activate a profile
skillswitch catalog# generate ~/.claude/SKILLS.md

Full command list — profiles, export/import, audit, per-CLI flags — in the README.

works with
Claude Code·Gemini CLI·Codex CLI·Aider·Amp·Factory Droid
install
npm install -g skillswitch