Skills que o agente lê e escreve
Uma skill é uma pasta com um arquivo SKILL.md, que ensina ao agente um procedimento: quando usar, os passos, as falhas conhecidas e como conferir o resultado. O Hermes guarda todas em ~/.hermes/skills/, inclusive as que o próprio agente escreve depois de uma tarefa trabalhosa.
Ir direto para o guia: Skills no Hermes
Ficha e sumário da página
- Referência técnica
- Hermes Agent v0.23.1
- Revisão
- 12 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Como uma skill chega ao modelo
O SKILL.md segue o padrão aberto do agentskills.io. No topo, um frontmatter em YAML traz o nome, a descrição e a versão. Abaixo, quatro seções com títulos fixos: quando usar, o procedimento, as armadilhas e a verificação. Uma skill maior ganha pastas ao lado do arquivo, como references/, templates/ e scripts/.
O agente não lê todas as skills a cada mensagem. O carregamento é progressivo: em toda conversa, ele vê só a lista com nome e descrição de cada skill. Quando uma tarefa combina com uma descrição, ele abre o SKILL.md daquela skill. Um arquivo de referência só é aberto quando uma etapa precisa dele.
~/.hermes/skills/devops/deploy-staging/SKILL.md
name:deploy-stagingdescription:Publica a branch atual no servidor de testesversion:1.0.0
## When to Usequando a skill se aplica## Procedureos passos, em ordem## Pitfallsfalhas conhecidas e a correção## Verificationcomo conferir que deu certo
Nível 0: a lista
Nome e descrição de todas as skills, cerca de 3 mil tokens. É o que o agente vê sempre.
Nível 1: o SKILL.md
O arquivo inteiro, carregado só quando a tarefa pede essa skill.
Nível 2: uma referência
Um arquivo de references/ ou templates/, lido quando uma etapa precisa dele.
Por isso a descrição pesa tanto. Ela é a única parte da skill que o modelo vê antes de decidir abri-la. Uma descrição vaga faz a skill ficar esquecida na pasta. Uma descrição ampla demais faz o agente carregá-la em tarefas que não têm relação com ela.
De onde vêm as skills
Empacotadas e do hub
- Empacotadas: vêm com o Hermes e entram em cada profile na instalação. O
hermes updatetraz as novas sem sobrescrever as que você editou. - Oficiais: ficam no repositório do Hermes, com identificador como
official/security/1password. - De terceiros: o diretório skills.sh, repositórios do GitHub e o endereço direto de um
SKILL.md. - Todas passam pela varredura de segurança antes de entrar na pasta.
Escritas pelo agente
- Depois de uma tarefa: o agente registra as etapas que funcionaram com a ferramenta
skill_manage. - Com
/learn: você aponta uma pasta, uma página ou a conversa atual. O agente monta a skill a partir dela. - Na correção: quando uma execução revela uma falha, o agente corrige a própria skill.
- Por padrão, essas mudanças valem na hora, sem revisão.
O /learn aceita quase qualquer fonte que você consiga descrever: o código de um SDK numa pasta da VPS, a documentação de uma API, o procedimento que você acabou de fazer com o agente na conversa ou um livro em PDF. Com uma fonte grande, o agente escreve uma skill de consulta: um SKILL.md curto com um índice, mais um arquivo por capítulo na pasta references/, lido só quando uma pergunta precisa dele.
A Central de Skills reúne skills indicadas pela Promovaweb, com o comando de instalação e os agentes compatíveis de cada uma, incluindo o Hermes.
Instale pelo hub
O hub é o catálogo de skills que o Hermes instala por comando. O caminho de uma skill nova tem quatro passos, todos com o usuário hermes:
Procure
hermes skills browseLista as skills de uma fonte, como as oficiais, ou busca pelo nome com o subcomando search.
Confira
hermes skills inspectMostra o conteúdo, a fonte e o nível de confiança antes de instalar.
Instale
hermes skills installBaixa para a quarentena, roda a varredura e registra a origem em .hub/lock.json.
Mantenha
hermes skills checkProcura versões novas. O update atualiza sem alterar as skills que você editou.
A varredura procura vazamento de arquivos e chaves, injeção de instruções, comandos destrutivos e sinais de pacote adulterado. O resultado depende do nível de confiança da fonte: as skills empacotadas e as oficiais são confiáveis. Alguns repositórios conhecidos recebem uma checagem mais flexível. O resto é tratado como comunidade.
Chame uma skill na conversa
Cada skill instalada vira um comando de barra com o nome dela, na TUI e na conversa com o bot. O texto depois do comando vira a instrução. Uma mensagem aceita até cinco skills empilhadas no começo:
/deploy-staging publique a branch atual/github-pr-workflow /test-driven-development corrija a issue 123 e abra um pull requestSem comando, o agente também escolhe sozinho pela descrição, quando a tarefa combina. Uma skill instalada no meio de uma conversa entra na próxima mensagem: o agente recebe um aviso com o nome e a descrição da skill nova.
Revise o que o agente escreve
Uma skill escrita pelo agente orienta as tarefas seguintes. Por isso vale ler o que ele grava. A opção skills.write_approval faz cada criação ou mudança esperar a sua revisão na pasta ~/.hermes/pending/skills/. Na conversa, /skills approval on liga a revisão e grava a opção no config.yaml. Depois, /skills pending lista o que espera, /skills diff mostra a diferença. Por fim, /skills approve ou /skills reject resolvem cada uma.
Para um profile começar sem as skills empacotadas, crie com hermes profile create pesquisa --no-skills. Num profile que já existe, hermes skills opt-out para as próximas cópias sem apagar nada do disco.
