convez.ai
SkillAutomaçãoIntermediário
StreamlinedStartup

Skillswoop

StreamlinedStartup/skillswoop

Gestor TUI/CLI para skills de agentes Claude com instalação e atualização

Ver no GitHub
InicialPluginScore · de 0 a 100

Interface TUI/CLI para gerenciar skills de agentes Claude Code e Codex. Funciona como front-end sobre o `npx skills`, permitindo memorizar repositórios, selecionar skills individuais, instalá-los em projetos e atualizá-los do GitHub com facilidade.

Instalação

$npx convez-ai StreamlinedStartup/skillswoop

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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
v0.4.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Instalar e gerenciar skills para agentes Claude em projetos
  • Atualizar skills do GitHub de forma centralizada
  • Buscar e selecionar skills de múltiplos repositórios
  • Compartilhar skills globalmente entre projetos

Veredito

Ferramenta prática e bem-implementada que abstrai a complexidade de gerenciar skills de agentes. Recomendada para quem usa Claude Code/Codex regularmente e precisa de fluxo de instalação ágil.

README

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

skillswoop

A terminal UI (and CLI) for managing agent skills for Claude Code and Codex. It is a front-end over npx skills: remember skill repositories, pick individual skills from a repo, install them into a project for one or more agents, and update them from GitHub.

The command is swoop.

Install

Homebrew (macOS / Linux)

brew install StreamlinedStartup/tap/swoop

Or tap first, then install by short name:

brew tap StreamlinedStartup/tap
brew install swoop

Then run swoop. Homebrew installs node as a dependency automatically. If brew install swoop can't find the formula, your tap clone is stale — run brew update and retry.

Prebuilt binary (no Homebrew, no Go)

Downloads the right binary for your OS/arch and puts it on your PATH:

OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m); case "$ARCH" in arm64|aarch64) ARCH=arm64;; x86_64|amd64) ARCH=x86_64;; esac
VER=$(curl -fsSL https://api.github.com/repos/StreamlinedStartup/skillswoop/releases/latest | grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4)
curl -fsSL "https://github.com/StreamlinedStartup/skillswoop/releases/download/${VER}/swoop_${VER#v}_${OS}_${ARCH}.tar.gz" | tar -xz swoop
sudo mv swoop /usr/local/bin/swoop   # or: mv swoop ~/.local/bin/

All builds are on the Releases page.

go install

Installs a binary named skillswoop into $(go env GOPATH)/bin:

go install github.com/StreamlinedStartup/skillswoop@latest
ln -sf "$(go env GOPATH)/bin/skillswoop" "$(go env GOPATH)/bin/swoop"   # optional: name it `swoop`

From source

git clone https://github.com/StreamlinedStartup/skillswoop
cd skillswoop && go build -o swoop . && sudo mv swoop /usr/local/bin/

Requirements

  • node / npx — used to run npx skills, which performs the actual install/update.
  • gh and/or git — used to list and clone repositories. gh (authenticated) is required for private repos. Optional otherwise.

Usage

Run swoop with no arguments for the TUI.

KeyAction
←/→, h/lswitch between Skills, Plugins, and Settings
↑/↓, j/kmove
spacemark (multi-select)
amark all / none
sstar / unstar the highlighted skill in a repo skill list
/fuzzy-filter skills in a repo skill list
enterselect / continue / confirm
ctrl+rrename a source (set a display alias)
tabtoggle project / global update scope from the main menu
?show contextual key help
escback · q quit

Skill and plugin installs add a destination confirmation after items are marked. Each confirmation starts on This project. Choose Globally when the same install should be available in every project. The main-menu scope indicator only controls updates and does not preselect an install destination.

Every action is also available as a non-interactive command:

swoop add owner/repo                              # remember a source
swoop use owner/repo -- --skill A --skill B -y    # install specific skills
swoop update                                      # update skills in the current folder
swoop update --all                                # update every folder you've installed into
swoop -g update                                   # update global skills
swoop browse <query>                              # search skills.sh
swoop stars                                       # list starred skills
swoop star owner/repo tdd review                  # star skills for quick reuse
swoop unstar owner/repo tdd                       # remove starred skills
swoop list | swoop remove | swoop agents claude-code codex
swoop --version

Plugins

Both agents have native plugin systems (plugins bundle skills, hooks, MCP servers, and commands/agents for Claude; hooks auto-wire on install). swoop drives each agent's own plugin CLI and installs to every compatible configured agent at once. In the TUI: Add a marketplace → Install plugins (rows show [hooks] / [mcp] badges) → choose This project or Globally → Remove plugins.

swoop mkt add anthropics/claude-plugins-official  # register a marketplace with claude + codex
swoop mkt list | swoop mkt update                 # cached marketplaces / refresh them
swoop plugin install anthropics/claude-plugins-official code-simplifier
swoop plugin list                                 # installed plugins across both agents
swoop plugin remove code-simplifier@claude-plugins-official
swoop mkt remove anthropics/claude-plugins-official

A marketplace repo may only ship one agent's manifest format — swoop installs to the agents it can and warns about the ones it skipped. Installing a hook-bearing plugin for Codex offers to enable codex features.hooks first (--no-hooks-enable skips that).

Scopes: -g installs user-wide (Claude --scope user, codex plugin add). In project scope, Claude installs with --scope project, and Codex plugins are vendored into the repo: copied to ./plugins/<name>/ and registered in ./.agents/plugins/marketplace.json, which Codex auto-discovers. Finish inside Codex with /plugins (install and enable) and /hooks (trust the plugin's hooks).

Where skills are installed

The TUI defaults every install confirmation to This project, which installs into the current directory:

  • Claude Code: ./.claude/skills/<name>
  • Codex: ./.agents/skills/<name>

-g installs to the global agent directories instead. Updates are tracked per directory via the skills-lock.json that npx skills writes.

Files

  • Config: ~/.config/swoop/ — sources, agents, projects, aliases, stars, marketplaces
  • Library (skills moved out by swoop stash): ~/.local/share/swoop/library/
  • Engine cache: ~/Library/Caches/swoop/ (macOS) or $XDG_CACHE_HOME/swoop/

Existing ~/.config/ccskill configuration is copied to ~/.config/swoop on first run.

How it works

swoop is a single Go binary: a Bubble Tea TUI with a Bash engine embedded via go:embed. On first run the engine is written to the cache directory and executed; it orchestrates npx skills, gh/git, and Node. Any command-line arguments are passed straight through to the engine.

License

MIT

Ver o original no GitHub

Bom para

Relacionados