skillmux
v0.1.0 · MIT · Go

Skill profiles
for coding agents.

Skillmux manages which Claude, Codex, and .agent skills your coding agents can see. Switch profiles between projects and your agent starts focused, not buried in skills it doesn’t need.

install
curl -fsSL https://raw.githubusercontent.com/boringstackoverflow/skillmux/main/install.sh | sh
brew brew install boringstackoverflow/tap/skillmux
go go install github.com/boringstackoverflow/skillmux/cmd/skillmux@latest
what it does

  • Profile-scoped skills

    Install every skill once. Activate only the ones that matter for the project you’re in now. Claude, Codex, and .agents folders all stay in sync — one command, all agents updated.

  • Native folder compatibility

    Works with ~/.claude/skills, ~/.codex/skills, ~/.agents/skills — including existing shared symlink topologies. Nothing breaks when you plug it in.

  • Reversible by design

    Every managed operation writes a TOML backup manifest before touching anything. Uninstall restores your original setup, recoverable by backup ID. No silent mutations.

in practice 
# first-time setup — links your agent skill folders to the work profile
$ skillmux init --profile work --yes

# create a profile for a different context
$ skillmux profile create research

# switch — all agents update instantly
$ skillmux use research

# confirm what's active
$ skillmux current
research

— init once, create profiles per context, switch in a single command