Gestão de competências: descoberta, ativação e prioridade
Nesta página
Lição atualizada em 2 de novembro de 2026 com base na página Skills da documentação do Vibe: adicionadas as localizações
.agents/skills/, a ordem oficial de descoberta (caminhos personalizados, projeto, utilizador) e o comando/reload. A documentação não define uma regra de prioridade para duas competências com o mesmo nome; a versão anterior descrevia uma. Fonte: Skills.
Como o Vibe descobre competências
Escrever uma competência é uma coisa; saber qual delas é realmente executada é outra. A documentação especifica a ordem pela qual o Vibe descobre as competências:
- Caminhos personalizados declarados em
config.tomlatravés deskill_paths; - Competências do projeto, localizadas em
./.vibe/skills/ou./.agents/skills/, carregadas apenas se a pasta for considerada segura (trusted); - Competências do utilizador, localizadas em
~/.vibe/skills/ou~/.agents/skills/.
As pastas .agents/skills/ seguem a especificação aberta Agent Skills: uma competência aí armazenada é partilhada com outros agentes que adotem a mesma especificação. Uma sessão ativa deteta competências adicionadas ou modificadas; se uma alteração não aparecer, digite /reload.
Estrutura do diretório de competências
As competências globais residem no seu diretório pessoal, cada uma na sua própria pasta contendo um SKILL.md. Estão disponíveis em qualquer lugar, em todos os projetos onde execute o Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
As competências locais, por outro lado, são versionadas juntamente com o código do projeto. Este é o local natural para uma competência de implementação ou migração, que depende da infraestrutura exata do repositório e não faria sentido noutro lugar.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
Finalmente, existem caminhos personalizados, usados para referenciar competências localizadas noutros locais do seu sistema. Declara-os na configuração:
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
Este é o mecanismo preferencial para partilhar competências dentro de uma equipa, através de uma pasta de rede ou de um repositório Git clonado que todos atualizam do seu lado.
Ativar e desativar competências
Por predefinição, todas as competências descobertas estão ativas. Duas configurações simétricas permitem-lhe retomar o controlo. Com enabled_skills, muda para uma lista branca: apenas as competências listadas estão ativas; todas as outras são ignoradas.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Com disabled_skills, mantém-se numa lista negra: todas as competências estão ativas exceto as que nomear. Esta é a escolha correta quando uma única competência está temporariamente a atrapalhar o seu trabalho.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Padrões de filtragem
Ambos os campos aceitam três formas de entrada. A mais simples é o nome exato, que funciona enquanto a lista permanecer curta:
enabled_skills = ["code-review", "test-generator", "doc-writer"]
Os padrões glob assumem o controlo assim que os seus nomes seguirem uma convenção. O caráter * corresponde a qualquer sequência de caracteres, permitindo-lhe gerir uma família inteira numa única linha:
# Ativar todas as competências que começam por "test-"
enabled_skills = ["test-*"]
# Desativar todas as competências experimentais
disabled_skills = ["experimental-*", "beta-*"]
Para casos que os globs não cobrem — uma alternativa, um padrão no meio de um nome, um sufixo numérico — prefixe a expressão com re: para usar uma expressão regular:
# Ativar competências cujo nome contenha "review" ou "audit"
enabled_skills = ["re:review|audit"]
# Desativar competências versionadas (ex: "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # cadeia literal: a barra invertida não precisa de escape
Duas competências com o mesmo nome
A documentação não descreve uma regra de prioridade para duas competências com o mesmo nome em locais diferentes. Portanto, não conte com uma “sobrescrita” implícita: dê-lhes nomes distintos (code-review-backend em vez de um segundo code-review) e verifique o que está realmente carregado. No menu /, a descrição de cada competência começa com o seu âmbito, project, user ou vibe, o que é suficiente para detetar um duplicado. Uma competência com o nome de um comando integrado não aparece neste menu.
Configuração ao nível do projeto
Todas estas definições combinam-se num ficheiro .vibe/config.toml colocado na raiz do projeto. O exemplo abaixo mostra as três alavancas em conjunto: restringir a lista às competências relevantes, excluir as que não o são e adicionar a pasta partilhada da equipa de backend.
# mon-projet/.vibe/config.toml
# Ativar apenas competências relevantes para este projeto
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# Ou desativar as que não são relevantes
disabled_skills = ["doc-writer"]
# Adicionar caminhos adicionais
skill_paths = ["/home/equipe/backend-skills"]
Para verificar quais as competências realmente disponíveis, abra o menu / na sessão: cada competência aparece lá com o seu âmbito. Este é o primeiro reflexo quando um comando de barra esperado permanece em falta, antes de tentar /reload e verificar o estado de confiança da pasta.
Pontos-chave
- O Vibe descobre competências em
~/.vibe/skills/,.vibe/skills/eskill_pathspersonalizados - As competências locais têm prioridade sobre as competências globais
- Use
enabled_skillsoudisabled_skillspara controlar a ativação - Padrões glob (
test-*) e regex (re:review|audit) simplificam a filtragem - Crie um
.vibe/config.tomlpor projeto para personalizar o contexto - Partilhe competências numa equipa através de
skill_pathsapontando para uma pasta comum