Skills do Hermes Agent: instalar e criar a sua própria skill

Uma skill é uma instrução guardada para um agente: descreve como realizar uma tarefa uma vez e, a partir daí, o Hermes aplica-a quando escreve /skill-name, sem precisar de repetir as explicações. Pode instalar uma skill pronta com um comando e criar a sua de duas formas: escrever o SKILL.md manualmente ou usar /learn.

Se ainda não instalou o Hermes, comece pelo guia o que é este agente e como instalá-lo e, depois, avance para as skills.

O que é uma skill no Hermes Agent?#

Escreve um pedido numa mensagem para o agente. A skill fica guardada num ficheiro separado, e o Hermes pode usar essa instrução em tarefas futuras. O agente tem acesso a uma lista de nomes e descrições e carrega o texto integral da skill quando esta é relevante para a tarefa. Isto poupa espaço no contexto: nem todas as instruções são carregadas de uma só vez.

Uma skill, por si só, não dá ao agente novas ferramentas nem acesso; descreve como usar as ferramentas que já tem. Uma nova integração com um serviço externo é feita através de MCP, que é um tema separado. Se uma tarefa exigir lógica de programa precisa, autorização especial ou processamento de fluxos de eventos, são necessárias ferramentas do agente; uma skill, por si só, não chega.

Escolha uma skill pronta para uma tarefa padrão se as instruções forem adequadas e a origem tiver sido verificada. Escreva a sua quando precisar de preservar uma sequência específica de ações, restrições e formato de saída. Use /learn quando já tiver materiais ou tiver concluído um processo e não quiser escrever o ficheiro manualmente.

O formato é aberto e compatível com a especificação Agent Skills, pelo que as skills de outros catálogos costumam funcionar no Hermes sem alterações ao formato, embora uma skill específica possa exigir as suas próprias ferramentas ou chaves. Também pode partilhar a sua skill, se quiser.

Que skills já estão instaladas e onde são guardadas?#

A pasta está organizada da seguinte forma:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

O SKILL.md é o único ficheiro obrigatório. Tudo o resto é acrescentado conforme necessário: references/ para materiais mais longos, scripts/ para programas auxiliares e templates/ e assets/ para modelos e ficheiros.

O catálogo integrado inclui skills para tarefas do dia a dia: encontrar GIFs, trabalhar com PDFs, folhas de cálculo, YouTube, GitHub e notas. A lista completa com descrições está na página do catálogo de skills integradas. A cada hermes update, o Hermes também atualiza as skills integradas, preservando as suas alterações.

Como instalar uma skill pronta do catálogo?#

1. Pesquise no catálogo

   hermes skills search pdf
   

   A pesquisa abrange todas as origens ligadas. Para ver o catálogo completo sem filtros, execute hermes skills browse.

2. Consulte a ficha da skill

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   A ficha mostra a descrição, a origem e o nível de confiança. Não instale uma skill de outra pessoa sem ler a respetiva ficha.

3. Instale-a

   hermes skills install skills-sh/anthropics/skills/pdf
   

   O Hermes transfere o SKILL.md e os ficheiros de apoio, executa uma verificação de segurança e coloca tudo em ~/.hermes/skills/. A skill fica imediatamente disponível como comando /pdf. Se precisar de ferramentas ou chaves adicionais, estas são indicadas no respetivo SKILL.md e o Hermes informa-o durante a instalação.

A verificação de segurança procura tentativas de enviar dados para o exterior, instruções injetadas para o agente e comandos que possam eliminar ou danificar ficheiros. As origens têm diferentes níveis de confiança:

Se a verificação emitir um aviso, pode continuar a instalação com a opção --force, mas leia primeiro o risco que foi detetado. Não é possível contornar um veredito “dangerous”. A verificação, por si só, não garante a segurança: antes de executar pela primeira vez a skill de outra pessoa, leia as instruções e os comandos associados.

Como instalar uma skill do GitHub ou através de uma ligação?#

Há três formas de instalar:

# 1. Uma skill específica de um repositório GitHub (o caminho dentro do repositório vem depois do respetivo nome)
hermes skills install anthropics/skills/skills/pdf

# 2. Uma ligação direta para um SKILL.md em qualquer site (partilhe esta skill numa conversa)
hermes skills install '<OFFICIAL_URL>'

# 3. Ligar um repositório inteiro como origem (substitua pelo seu proprietário e repositório)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

No caso de uma ligação direta, o Hermes transfere o SKILL.md e apenas os ficheiros mencionados nas subpastas de serviço; não transfere ficheiros não relacionados do site. A ligação fica guardada como origem, e hermes skills update atualizará posteriormente a skill a partir do mesmo endereço.

Além do GitHub, é possível ligar catálogos externos de competências. Pode pesquisar neles com o mesmo comando hermes skills search, indicando a origem.

Como usar uma skill depois de a instalar?#

Introduza os comandos hermes ... no terminal e as invocações /skill-name numa conversa com o agente (no mesmo terminal, na interface Web ou num serviço de mensagens):

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

Se introduzir /skill-name sem uma tarefa, o Hermes carrega as instruções e pergunta o que pretende que faça. Pode invocar várias skills numa só linha, até cinco; o texto restante passa a ser a tarefa:

/github-pr-workflow /test-driven-development close issue 123 and open a PR

Para combinações usadas regularmente, existem pacotes de skills, chamados bundles na terminologia do Hermes: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development agrupa várias skills num único comando curto /backend-dev. Um bundle funciona como um alias; as skills que contém têm de estar instaladas previamente.

Os comandos com barra também funcionam no Telegram se o gateway estiver ligado; a configuração é explicada no guia como ligar o Hermes Agent ao Telegram. É também uma forma prática de executar skills a partir do telemóvel.

Como criar a sua própria skill: o que incluir no SKILL.md?#

Pode copiar esta skill e adaptá-la às suas necessidades:

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

O cabeçalho entre os três traços é composto por metadados. Os campos principais são name (em letras latinas, com palavras separadas por hífen, e usado para invocar a skill como comando) e description. O agente usa o campo description para decidir se a skill se adequa à tarefa atual e deve ser carregada. Se a descrição for vaga, a skill poderá não ser carregada quando for necessária.

Ao cabeçalho seguem-se secções de instruções. When to Use indica quando carregar a skill. Procedure apresenta os passos. Pitfalls aborda os erros que o agente costuma cometer e como evitá-los. Verification explica como verificar o resultado. Se as instruções forem longas, transfira o conteúdo principal para ficheiros em references/; estes só serão carregados quando forem necessários. Coloque os programas auxiliares em scripts/.

Se uma skill precisar de uma chave de API, declare-a no cabeçalho com required_environment_variables; não inclua a própria chave no ficheiro, declare apenas o nome da variável. O Hermes pedirá o valor uma vez, na primeira invocação num terminal local, e depois irá fornecê-lo automaticamente (nos serviços de mensagens, pedirá que configure a chave localmente). Os campos platforms, config, blueprint e outros são descritos na página oficial da documentação Creating Skills.

Com o ficheiro pronto, siga estes passos:

1. Crie a pasta da skill

   mkdir -p ~/.hermes/skills/weekly-review
   

   O nome da pasta corresponde ao campo name do cabeçalho.

2. Guarde o SKILL.md

   Coloque um ficheiro chamado SKILL.md com as suas instruções na pasta; pode usar o exemplo acima e adaptá-lo à sua tarefa.

3. Invoque a skill e verifique-a

   Introduza /weekly-review e peça ao agente que reveja a sua semana. Se seguir os passos das instruções, a skill funciona.

Como criar uma skill a partir de materiais existentes com /learn?#

/learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn how I just published a site to hosting

Se acabou de concluir um processo complexo com o agente, peça ao /learn que o guarde como skill enquanto todos os passos ainda estão na conversa. Da próxima vez, o Hermes repetirá o procedimento com as instruções prontas.

Uma fonte extensa, como um livro, uma especificação ou um arquivo de documentos, não cabe num único ficheiro. O Hermes cria um SKILL.md compacto com um mapa de tópicos e transfere os detalhes para references/. Estes ficheiros não ocupam espaço no contexto até o agente os carregar para responder a uma pergunta. Se voltar a executar /learn sobre o mesmo tópico, este acrescenta conteúdo à skill existente em vez de criar uma duplicada.

Como verificar se uma skill funciona?#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

Este é o teste recomendado pela documentação: execute a skill e confirme que o agente segue as suas instruções. Se não o fizer, verifique três causas possíveis. Primeiro, o nome da pasta ou o name do cabeçalho poderá não corresponder ao nome que invoca. Segundo, a descrição poderá não deixar claro em que circunstâncias a skill deve ser usada; reescreva-a com as palavras da própria tarefa. Terceiro, a pasta poderá não estar em ~/.hermes/skills/, pelo que o Hermes não a consegue ver. Tenha em conta que a opção --toolsets skills limita o conjunto de ferramentas do teste: mostra como o agente trabalha com a instrução, mas não verifica as dependências da skill, como programas externos.

O comando hermes skills list no terminal mostra exatamente o que está instalado.

Como atualizar e remover skills?#

hermes skills check      # what changed at the sources
hermes skills update     # download new versions
hermes skills uninstall pdf   # remove a skill from the hub

Para remover uma skill criada manualmente, elimine a respetiva pasta de ~/.hermes/skills/. Se personalizou a skill de outra pessoa, update não a altera: o Hermes compara hashes e ignora os ficheiros modificados para evitar substituir o seu trabalho. Para restaurar a versão original de uma skill do hub, use hermes skills update name --force; para uma skill integrada, use hermes skills reset name --restore. Ambos os comandos substituem as suas alterações, por isso guarde primeiro a sua versão.

Se não precisar das skills integradas e estas sobrecarregarem a lista, hermes skills opt-out desativa a sua inclusão durante as atualizações. O comando opt-out --remove também remove as que não alterou.

O que fazer se uma skill não instalar ou não funcionar?#

O Hermes encontra skills nas pastas .hermes/skills/ e .agents/skills/ dentro de um repositório Git. Antes de as carregar, tem de marcar o repositório como fidedigno: estes ficheiros contêm instruções que o agente irá seguir. Depois disso, as skills do repositório só funcionam dentro dele e passam pela mesma verificação de segurança. Só precisa de marcar o repositório como fidedigno uma vez.

O que deve fazer primeiro?#

A seguir, sobre este tema: como ligar o Hermes Agent ao Telegram, para poder invocar skills a partir do telemóvel, e como manter um agente em execução num servidor 24 horas por dia, se quiser skills agendadas. Se estiver a escolher um agente, consulte a comparação OpenClaw ou Hermes Agent.