Instalar agentes, skills e MCPs
Como trazer para a pasta de trabalho um agente, com as skills e os MCPs que ele declara, uma skill ou um MCP.
Traz um agente (com as skills e os MCPs que ele declara), uma skill ou um MCP para a pasta de trabalho, substituindo o que já estiver no destino:
bun choliba add <origem> [--path <item na origem>] [--dry-run]<origem>é uma pasta local, um repositório git (https://…,git@…,github:dono/repo[#ref], ...) ou um pacote npm (nome ounome@versão).--pathescolhe o item dentro da origem (ex.:--path .choliba/agents/test-writer), para origens com mais de um agente, skill ou MCP. Sem--path, a origem já precisa ser o item: uma pasta comagent.yamlouSKILL.md, ou um arquivo.json.--dry-runmostra o que seria instalado, sem gravar nada.
Instalar um agente também traz as skills e os MCPs que ele declara, quando estão na origem; os que faltam saem como aviso, para instalar à parte. Se o .json de um MCP usa uma variável (${NOME}) sem valor no .env, isso também aparece como aviso.
O que o repositório do choliba oferece
| Tipo | Caminho na origem | Para quê |
|---|---|---|
| agente | .choliba/agents/product-owner | Escreve o ticket com critérios de aceite, usando a aplicação no navegador. |
| agente | .choliba/agents/test-writer | Escreve um teste por critério, antes da implementação. |
| agente | .choliba/agents/implementer | Muda a aplicação até os testes do ticket passarem. |
| agente | .choliba/agents/tech-stack-analyzer | Registra a stack da aplicação em stack, no config.json do projeto. |
| skill | .choliba/skills/playwright-cli | Ensina o agente a usar o navegador (a ferramenta da run playwright-cli). |
| skill | .choliba/skills/playwright-trace | Ensina o agente a ler o trace.zip de um teste que falhou. |
| skill | .choliba/skills/playwright-component-testing | Testes de componente com Playwright. |
As três skills playwright-* são cópias das skills oficiais do Playwright, na versão do @playwright/test que o choliba usa (1.63.0). Para instalá-las direto da fonte oficial, veja Skills oficiais do Playwright.
Exemplos
As saídas abaixo são de execuções reais, numa pasta de trabalho recém-criada com bun add --trust (veja Instalação).
Os agentes do choliba
Cada agente traz as skills e os MCPs que declara, do mesmo repositório:
$ bun choliba add github:choliba/choliba --path .choliba/agents/product-owner
Instalado:
agente product-owner → .choliba/agents/product-owner
skill playwright-cli → .choliba/skills/playwright-cli
Confira com: bun choliba check$ bun choliba add github:choliba/choliba --path .choliba/agents/test-writer
Instalado:
agente test-writer → .choliba/agents/test-writer
skill playwright-cli → .choliba/skills/playwright-cli
skill playwright-trace → .choliba/skills/playwright-trace
Confira com: bun choliba check$ bun choliba add github:choliba/choliba --path .choliba/agents/implementer
Instalado:
agente implementer → .choliba/agents/implementer
skill playwright-trace → .choliba/skills/playwright-trace
Confira com: bun choliba checkUma skill ou um MCP sozinho
$ bun choliba add github:choliba/choliba --path .choliba/skills/playwright-trace
Instalado:
skill playwright-trace → .choliba/skills/playwright-trace
Confira com: bun choliba checkSkills oficiais do Playwright
As skills oficiais estão em dois lugares, e o add aceita os dois:
| Fonte | --path |
|---|---|
| repositório microsoft/playwright-cli | skills/playwright-cli |
pacote npm @playwright/cli, do mesmo repositório | skills/playwright-cli |
pacote npm playwright-core@<versão> | lib/tools/skills/<skill> |
O playwright-core traz as três (playwright-cli, playwright-trace e playwright-component-testing). Fixe a versão igual à do Playwright da pasta de trabalho (bunx playwright --version), para a skill descrever os comandos que você tem.
$ bun choliba add github:microsoft/playwright-cli --path skills/playwright-cli
Instalado:
skill playwright-cli → .choliba/skills/playwright-cli
Confira com: bun choliba check$ bun choliba add playwright-core@1.63.0 --path lib/tools/skills/playwright-trace
Instalado:
skill playwright-trace → .choliba/skills/playwright-trace
Confira com: bun choliba check$ bun choliba add @playwright/cli --path skills/playwright-cli --dry-run
Instalaria (--dry-run, nada foi gravado):
skill playwright-cli → .choliba/skills/playwright-cli
Confira com: bun choliba checkNessas origens o --path é obrigatório, porque a origem não é o item. Sem ele, o add lista os itens que encontra numa origem organizada como uma pasta de trabalho (.choliba/agents/, .choliba/skills/, .choliba/mcps/) ou com essas pastas na raiz (agents/, skills/, mcps/); fora disso, não lista nada.
O texto das skills oficiais usa playwright-cli e npx playwright trace. Os agentes do choliba traduzem isso na instrução de cada skill no agent.yaml: as ferramentas da run playwright-cli e playwright-trace, que rodam a versão do Playwright do choliba (veja Ferramentas da run).
Outras origens
Uma branch ou tag, um clone local, ou só para ver o que seria instalado (--dry-run):
$ bun choliba add github:choliba/choliba#develop --path .choliba/agents/test-writer --dry-run
Instalaria (--dry-run, nada foi gravado):
agente test-writer → .choliba/agents/test-writer
skill playwright-cli → .choliba/skills/playwright-cli
skill playwright-trace → .choliba/skills/playwright-trace
Confira com: bun choliba check$ bun choliba add ../choliba --path .choliba/agents/implementer --dry-run
Instalaria (--dry-run, nada foi gravado):
agente implementer → .choliba/agents/implementer
skill playwright-trace → .choliba/skills/playwright-trace
Confira com: bun choliba check