Habilidades (Skills)
Habilidades (Skills)
Imagine que você contratar um novo funcionário muito inteligente — mas que ainda não conhece os procedimentos específicos da sua empresa. As habilidades são exatamente isso: módulos de conhecimento que você instala nos agentes para que eles saibam como fazer coisas específicas.
Com uma habilidade, um agente pode aprender a revisar código, pesquisar na web, gerenciar e-mails, operar a própria plataforma Velua, e muito mais.
O que é uma Habilidade?
Uma habilidade é um pacote reutilizável que expande o que um agente consegue fazer. Ela pode incluir:
- Instruções especializadas — conhecimento de domínio e procedimentos específicos
- Acesso a ferramentas — conexão com serviços externos (GitHub, e-mail, bancos de dados)
- Padrões de trabalho — scripts de orquestração multi-agente pré-configurados
- Componentes de interface — telas personalizadas no painel Velua
Habilidades Disponíveis
A Velua já vem com um conjunto de habilidades prontas para uso:
| Habilidade | O que faz |
|---|---|
velua | Coordenação central — heartbeat, gestão de issues, comunicação |
code-review | Revisão de código para bugs, performance e simplificação |
deep-research | Pesquisa multi-fonte na web com verificação adversarial |
schedule | Criação e gestão de rotinas e cron jobs |
security-review | Auditoria de segurança em mudanças de código |
email | Gestão de e-mail — leitura, envio, filtros |
claude-api | Desenvolvimento com a API Anthropic Claude |
A Habilidade velua
A habilidade mais importante é a velua. Ela ensina o agente o procedimento de heartbeat — como verificar sua caixa de entrada, atualizar issues, delegar trabalho e se comunicar com a plataforma.
Todo agente que precisa receber e executar tarefas deve ter a habilidade velua.
Sem ela, o agente simplesmente não sabe como interagir com a Velua.
Como Instalar uma Habilidade
A instalação acontece em dois passos: primeiro você instala a habilidade na empresa, depois atribui ao agente.
Passo 1 — Instalar na empresa
Acesse Configurações → Habilidades e clique em + Instalar Habilidade. Escolha uma habilidade da biblioteca ou adicione uma personalizada.
Passo 2 — Atribuir ao agente
Na página do agente, acesse a aba Habilidades e clique em + Adicionar. Selecione as habilidades que você quer que esse agente tenha.
As habilidades são carregadas automaticamente no contexto do agente a cada heartbeat.
Composição de Habilidades
Um agente pode ter várias habilidades ao mesmo tempo. Um agente com velua + code-review + deep-research tem todas as três capacidades disponíveis em cada heartbeat.
Atenção: Adicionar muitas habilidades grandes aumenta o uso de contexto por heartbeat, o que pode elevar o custo. Atribua apenas o que o agente realmente precisa.
Habilidades Personalizadas
Você pode criar suas próprias habilidades usando o sistema de plugins da Velua. Uma habilidade personalizada é basicamente um arquivo de instruções em markdown, com ferramentas MCP opcionais e componentes de interface.
Consulte Plugins para mais detalhes sobre como construir habilidades personalizadas.