Verboo

Skills

Skills são automações reutilizáveis invocadas como slash commands. Cada skill encapsula um prompt especializado, ferramentas permitidas e, opcionalmente, hooks de ciclo de vida. O agente executa a skill como se fosse uma instrução completa, mantendo o contexto da sessão.

Como invocar uma skill

/nome-da-skill [argumento opcional]

Exemplos:

/simplify
/loop 5m verificar deploys com falha
/schedule
/update-config

Skills bundled (built-in)

As skills a seguir são compiladas no binário do Verboo Code e disponíveis em qualquer instalação.

`/update-config`

Modifica settings.json ou settings.local.json de forma segura. Inclui um workflow de verificação de hooks em 7 passos que testa o hook antes de salvar.

Quando usar: "adicione uma permissão para Bash(npx tsc *)", "configure um hook que formate arquivos ao salvar", "habilite auto-compactação"

Ferramentas disponíveis: apenas Read (não edita arquivos diretamente — usa o tool de config)

`/simplify`

Analisa o código alterado recentemente usando 3 agentes em paralelo, cada um com um foco diferente:

  • Agent 1 — Reuso de código: detecta helpers existentes sendo reinventados, duplicação de lógica
  • Agent 2 — Qualidade: identifica estado redundante, parameter sprawl, lógica inline complexa, JSX desnecessário, comentários óbvios
  • Agent 3 — Eficiência: aponta trabalho desnecessário, concorrência perdida, operações caras em hot-paths, memory leaks

Após os 3 agentes reportarem, agrega os findings e aplica as correções.

Quando usar: após implementar uma feature, antes de abrir PR

`/loop [intervalo] [prompt]`

Executa um prompt em loop contínuo. Dois modos:

Intervalo fixo com prompt:

/loop 5m checar builds com falha no CI
/loop 2h enviar relatório de progresso

Loop dinâmico (sem intervalo): O agente decide o próximo wake-up com base no que encontrar.

/loop babysit deploys até verde

Loop de manutenção (sem argumento): Trabalha no que estiver pendente — PR aberto, CI com falha, trabalho inacabado.

/loop

O intervalo mínimo é 1 minuto, máximo 1 hora. Formatos aceitos: 1m, 30s, 2h, 1 minute, 30 seconds.

`/schedule`

Cria, lista e gerencia remote agents com cron expression — agentes que rodam autonomamente na infraestrutura da Verboo.

Fluxo:

  1. Descreva o objetivo do agente
  2. O skill monta o prompt
  3. Defina o cron (ex: 0 9 * * 1-5 = dias úteis às 9h)
  4. Escolha o modelo (padrão: claude-sonnet-4-6)
  5. Confirme e crie
/schedule

Requer conta Verboo com permissão de remote agents.

`/keybindings-help`

Guia interativo para customizar ~/.verboo/keybindings.json. Explica sintaxe de modificadores (ctrl, alt, shift, meta), teclas especiais, chords (sequências), como remover bindings existentes e regras de validação.

`/batch`

Processa múltiplas tarefas em lote via Claude API (Batch API). Útil para rodar análises em muitos arquivos ou gerar conteúdo em escala.

Requer ANTHROPIC_API_KEY configurada.

`/claude-api`

Auxilia no desenvolvimento de aplicações que usam o SDK Anthropic. Orienta sobre prompt caching, tool use, streaming, modelos disponíveis e migração entre versões.

Skills externas (`.verboo/skills/`)

Você pode criar suas próprias skills em Markdown e carregá-las automaticamente.

Estrutura de diretório

.verboo/
  skills/
    minha-categoria/
      minha-skill/
        SKILL.md          ← obrigatório
        referencia.txt    ← arquivos de contexto opcionais

O nome do arquivo SKILL.md define o slug da skill (o diretório pai é o nome).

Formato do SKILL.md

markdown
---
name: minha-skill
description: "O que essa skill faz — exibido em /skills"
when-to-use: "Use quando o usuário pedir X"
allowed-tools: [Bash, Read, Edit]
argument-hint: "[nome-do-arquivo]"
model: claude-sonnet-4-6
user-invocable: true
---

Você é um especialista em [domínio].

Quando invocado com `{{args}}`, faça:
1. ...
2. ...

Contexto adicional está em referencia.txt.

Campos do frontmatter

Campo Tipo Descrição
name string Slug do comando (padrão: nome do diretório)
description string Descrição exibida em /skills
when-to-use string Hint para o modelo sobre quando invocar
allowed-tools string[] Ferramentas que o skill pode usar
argument-hint string Hint de argumento exibido ao usuário
model string Modelo específico para essa skill
disable-model-invocation bool Se true, apenas injeta o prompt sem invocar o modelo
user-invocable bool Se false, a skill fica oculta para o usuário
hooks object Hooks do ciclo de vida específicos da skill
context 'fork' Executa em contexto isolado (fork)
paths string Padrões gitignore para activation condicional
effort s/m/l/xl Nível de esforço esperado

Activation condicional por caminho

Skills com paths: no frontmatter só ficam ativas quando arquivos matching são tocados na sessão:

markdown
---
name: review-tests
description: "Review de testes Jest"
paths: "**/*.test.ts\n**/__tests__/**"
---

Isso evita poluir /skills com skills irrelevantes para o contexto atual.

Precedência de carregamento

Quando skills têm o mesmo nome, a seguinte ordem de precedência se aplica (maior ganha):

  1. Managed — skills gerenciadas pela plataforma Verboo
  2. User — ~/.verboo/skills/
  3. Project — .verboo/skills/ no projeto
  4. Legacy — .verboo/commands/ (deprecated)

Localização das skills

O Verboo Code busca skills em:

  • ~/.verboo/skills/ — skills globais do usuário
  • .verboo/skills/ — skills do projeto (walk-up até $HOME)
  • Diretórios adicionados com --add-dir

Skills via MCP

Servidores MCP podem expor skills que são carregadas automaticamente quando o servidor está conectado. Cada ferramenta MCP pode ser invocada como skill se o servidor exportar um prefixo de skill no seu metadata.

Veja MCP para mais detalhes.