Skillswoop
StreamlinedStartup/skillswoop
Gestor TUI/CLI para skills de agentes Claude com instalação e atualização
Ver no GitHubInterface 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/skillswoop1 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
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 runnpx skills, which performs the actual install/update.ghand/orgit— used to list and clone repositories.gh(authenticated) is required for private repos. Optional otherwise.
Usage
Run swoop with no arguments for the TUI.
| Key | Action |
|---|---|
←/→, h/l | switch between Skills, Plugins, and Settings |
↑/↓, j/k | move |
space | mark (multi-select) |
a | mark all / none |
s | star / unstar the highlighted skill in a repo skill list |
/ | fuzzy-filter skills in a repo skill list |
enter | select / continue / confirm |
ctrl+r | rename a source (set a display alias) |
tab | toggle project / global update scope from the main menu |
? | show contextual key help |
esc | back · 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.