convez.ai
SkillAutomaçãoIntermediário
nikolas-sapa

Skillswitch

nikolas-sapa/skillswitch

Gerencie skills de IA CLI com perfis, desabilite em massa, economize tokens.

Ver no GitHub
InicialPluginScore · de 0 a 100

Gerenciador de skills para CLIs de IA (Claude Code, Gemini CLI, Codex, Aider, Amp, Factory Droid). Economiza tokens de contexto desabilitando skills desnecessários, cria perfis para diferentes contextos de trabalho e cataloga skills instalados. Resolve o problema de vazamento de contexto quando centenas de skills são injetadas automaticamente em cada sessão.

Instalação

$npx convez-ai nikolas-sapa/skillswitch

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
2
Acompanhando
1
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Otimizar janela de contexto desabilitando skills não utilizados
  • Criar perfis de skills para diferentes fluxos de trabalho (dev, docs, data)
  • Auditar duplicatas e skills órfãs na configuração
  • Sincronizar configuração de skills entre múltiplas CLIs de IA

Veredito

Ferramenta essencial para quem trabalha com múltiplas CLIs de IA e tem centenas de skills instalados. Resolve efetivamente o problema crítico de desperdício de tokens e oferece controle fino via perfis e busca.

README

A tradução para o português deste README ainda está na fila.

skillswitch

Manage AI CLI skills across Claude Code, Gemini CLI, Codex CLI, Aider, Amp, and Factory Droid — profiles, disable/enable, catalog generation.

Running 100+ Claude Code skills? Your context window is leaking. Claude Code injects every installed skill name into every session. With 450 skills, that's thousands of tokens burned before your first message.

skillswitch fixes this — and works across every major AI CLI.

Install

npm install -g skillswitch
# or run without installing:
npx skillswitch <command>

Supported CLIs

CLIFlagSkill location
Claude Code--for claude (default)~/.claude/skills/ + plugins
Gemini CLI--for gemini~/.gemini/skills/ + ~/.agents/skills/
Codex CLI--for codex~/.agents/skills/
Aider--for aider~/.aider/skills/ (managed externally)
Amp (Sourcegraph)--for amp~/.config/amp/skills/ + ~/.agents/skills/
Factory Droid--for droid~/.factory/droids/ + ~/.factory/commands/

Commands

skillswitch detect                        # show which CLIs are installed

# Claude Code (default)
skillswitch status                        # how many skills are active vs disabled
skillswitch list                          # all skills by source
skillswitch list --disabled               # only disabled skills
skillswitch search <query>                # find skills by name or description

skillswitch disable <name>                # disable standalone skill (substring match)
skillswitch disable --plugin <id>         # disable entire plugin
skillswitch enable <name>                 # re-enable standalone skill
skillswitch enable --plugin <id>          # re-enable entire plugin

skillswitch profile create <name>         # snapshot current enabled set
skillswitch profile use <name>            # activate a profile
skillswitch profile use <name> --dry-run  # preview what would change
skillswitch profile list                  # list saved profiles
skillswitch profile show <name>           # see what's in a profile
skillswitch profile delete <name>         # remove a profile
skillswitch profile rename <old> <new>    # rename a profile
skillswitch profile copy <src> <dst>      # duplicate a profile
skillswitch profile diff <name>           # what changes on activate
skillswitch profile export <name>         # export profile to JSON
skillswitch profile import <file>         # import profile from JSON
skillswitch profile validate <name>       # detect ghost skills

skillswitch catalog                       # generate ~/.claude/SKILLS.md
skillswitch audit                         # find duplicates and stale disabled skills

# Other CLIs — use --for <cli>
skillswitch --for gemini list
skillswitch --for codex disable tdd
skillswitch --for amp search coding
skillswitch --for droid status
skillswitch --for aider list
skillswitch aider-config                  # print the read: block for ~/.aider.conf.yml

Typical workflow

# See what's installed
skillswitch detect

# Start with everything enabled (your current state)
skillswitch profile create full           # save the 450-skill state

# Trim down for dev work
skillswitch disable --plugin aso-skills@aso-skills
skillswitch disable ads                   # disables all skills with "ads" in the name
skillswitch profile create dev            # save the lean set

# Switch contexts
skillswitch profile use dev               # 48 skills active
skillswitch profile use full              # back to 450

# Manage skills for other CLIs
skillswitch --for gemini list
skillswitch --for gemini disable research
skillswitch --for codex disable tdd

# Discover what you have
skillswitch catalog                       # generates ~/.claude/SKILLS.md
# Then in Claude: @~/.claude/SKILLS.md

How it works

  • Standalone skills (~/.claude/skills/*.md): disabled by moving to .disabled/ subdirectory — always reversible, nothing deleted
  • Plugin skills (~/.claude/plugins/): disabled by writing to Claude Code's native blocklist.json
  • Other CLIs: skill files moved to .disabled/ subdirectory inside their skills directory
  • Profiles stored in ~/.claude/skillctl/profiles.json

No telemetry, no auth, no network — pure local filesystem tool.

License

MIT

Ver o original no GitHub

Bom para

Relacionados