Skip to content

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 ou nome@versão).
  • --path escolhe 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 com agent.yaml ou SKILL.md, ou um arquivo .json.
  • --dry-run mostra 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 ​

TipoCaminho na origemPara quê
agente.choliba/agents/product-ownerEscreve o ticket com critérios de aceite, usando a aplicação no navegador.
agente.choliba/agents/test-writerEscreve um teste por critério, antes da implementação.
agente.choliba/agents/implementerMuda a aplicação até os testes do ticket passarem.
agente.choliba/agents/tech-stack-analyzerRegistra a stack da aplicação em stack, no config.json do projeto.
skill.choliba/skills/playwright-cliEnsina o agente a usar o navegador (a ferramenta da run playwright-cli).
skill.choliba/skills/playwright-traceEnsina o agente a ler o trace.zip de um teste que falhou.
skill.choliba/skills/playwright-component-testingTestes 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 check

Uma 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 check

Skills oficiais do Playwright ​

As skills oficiais estão em dois lugares, e o add aceita os dois:

Fonte--path
repositório microsoft/playwright-cliskills/playwright-cli
pacote npm @playwright/cli, do mesmo repositórioskills/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 check

Nessas 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