# Skills do Hermes Agent: instalar e criar a sua própria skill > Diretórios e GitHub, o formato SKILL.md, /learn, verificação, atualização e remoção de skills do Hermes Agent, com exemplos completos de comandos. Source: https://ailoot.ai/blog/pt-pt/hermes-agent-skills/ Canonical: https://ailoot.ai/blog/pt-pt/hermes-agent-skills/ Language: pt-PT Publisher: Ailoot (https://ailoot.ai/) Translation: guide-117 Revision: sha256-9626dcb1fb60bc6adc0390b7f0db392e5e99eb0ac8a97a804f34957d215a204c 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](https://ailoot.ai/blog/pt-pt/hermes-agent-install-setup/) e, depois, avance para as skills.
As instruções práticas para usar o Ailoot estão na [documentação](https://ailoot.ai/docs/).
## O que é uma skill no Hermes Agent?
Conclusão principal Uma skill é um ficheiro com instruções para um agente: o que fazer, que comandos usar, a que aspetos prestar atenção e onde costumam ocorrer erros. Fica guardada na pasta `~/.hermes/skills/` como ficheiro SKILL.md, juntamente com quaisquer materiais de apoio. Depois de instalada, a skill passa automaticamente a estar disponível como comando `/name` em qualquer conversa com o agente.
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.

As skills são documentos com informações de que um agente precisa e que só carrega quando necessário.

— Documentação do Hermes Agent (traduzida do inglês), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
O formato é aberto e compatível com a [especificação Agent Skills](https://agentskills.io/specification), 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?
Conclusão principal Por predefinição, as skills são guardadas na pasta `~/.hermes/skills/`, organizadas em subpastas por categoria (se usar um perfil não padrão ou a variável HERMES_HOME, o caminho será diferente; `hermes config path` mostra-o). Depois da instalação, o Hermes já inclui dezenas de skills integradas, desde pesquisar no arXiv até trabalhar com o GitHub e documentos. O comando `hermes skills list` mostra a lista, e também pode perguntar ao agente, na conversa, que skills tem.
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](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog). 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?
Conclusão principal Abra o catálogo com `hermes skills browse`, encontre o que precisa com `hermes skills search`, veja a ficha de uma skill com `hermes skills inspect` e instale-a com `hermes skills install`. Todas as skills passam por uma verificação de segurança antes da instalação, e as skills oficiais não apresentam um aviso de origem de terceiros.
1. ### Pesquise no catálogo ```bash 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 ```bash 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 ```bash 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: | Nível | Origem da skill | O que acontece durante a instalação | |----|----|----| | Integrada | Incluída no Hermes | Já está disponível; não é necessária instalação | | Oficial | Pasta de skills opcionais no repositório do Hermes | Instalada sem aviso de origem de terceiros: `hermes skills install official/security/1password` | | Fidedigna | Repositórios openai/skills, anthropics/skills, huggingface/skills e NVIDIA/skills | Verificação menos rigorosa | | Outra | Catálogos, repositórios de GitHub de outras pessoas, ligações diretas | Aviso e verificação completa | 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?
Conclusão principal Instale uma skill do GitHub com `hermes skills install owner/repository/path` ou use uma ligação direta para um ficheiro SKILL.md; o Hermes transfere os ficheiros associados. Pode ligar uma origem própria de skills com `hermes skills tap add`, que passa depois a funcionar como qualquer outro catálogo.
Há três formas de instalar: ```bash # 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 '' # 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.
Atenção O GitHub limita os pedidos não autenticados a 60 por hora. Se receber erros de limite de pedidos ao instalar ou pesquisar, adicione `GITHUB_TOKEN` ao ficheiro `~/.hermes/.env`; o limite aumentará para 5000 pedidos por hora.
## Como usar uma skill depois de a instalar?
Conclusão principal Uma skill instalada passa automaticamente a ser um comando: escreva `/skill-name` e a tarefa na mesma linha. Não é necessária ativação separada. Funciona no terminal, na interface Web e em serviços de mensagens através do gateway. Pode invocar até cinco skills numa única mensagem ou transformar uma combinação recorrente num único comando.
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](https://ailoot.ai/blog/pt-pt/hermes-agent-telegram-setup/). É 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?
Conclusão principal A sua própria skill é uma pasta em `~/.hermes/skills/` com um ficheiro obrigatório, SKILL.md: um cabeçalho curto com um nome e uma descrição, seguido de instruções organizadas por secções — quando a usar, a sequência de ações, erros comuns e verificação. É escrita em texto simples; não é necessário programar. Para uma versão simples, basta uma pasta e um ficheiro.

As skills são a principal forma de acrescentar novas capacidades ao Hermes Agent: são mais fáceis de criar do que ferramentas, não exigem alterações ao código do agente e podem ser partilhadas com a comunidade.

— Documentação do Hermes Agent (traduzida do inglês), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills
Pode copiar esta skill e adaptá-la às suas necessidades: ```markdown --- 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/`.
Dica Coloque primeiro o cenário mais comum e deixe os casos raros para o fim do ficheiro. O Hermes lê uma skill de cima para baixo, e esta ordem poupa contexto.
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](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills). Com o ficheiro pronto, siga estes passos: 1. ### Crie a pasta da skill ```bash 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?
Conclusão principal O comando `/learn` cria uma skill a partir de materiais existentes: indique uma pasta de documentação, a ligação para uma página, as suas notas ou uma descrição verbal de um processo, e o Hermes escreve um SKILL.md de acordo com as convenções aceites, para que o possa rever. Um livro ou um arquivo extenso dará origem a uma skill com ficheiros separados por tópico.
``` /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?
Conclusão principal Para a verificar, execute `hermes chat --toolsets skills -q` e dê-lhe um pedido relacionado com a skill, por exemplo, peça-lhe que reveja uma semana usando uma lista de tarefas. Se o agente organizar as tarefas nos grupos definidos nas suas instruções, a skill funciona. Se responder como habitualmente, verifique o nome do ficheiro, a descrição no cabeçalho e a localização da pasta.
```bash 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?
Conclusão principal `hermes skills check` mostra quais as skills instaladas que foram atualizadas na respetiva origem, `hermes skills update` transfere as novas versões e `hermes skills uninstall name` remove uma skill. As suas edições a uma skill de outra pessoa são preservadas durante as atualizações: o Hermes ignora os ficheiros alterados. Pode restaurar a versão original: para uma skill do hub, use `hermes skills update name --force`; para uma skill integrada, use `hermes skills reset name --restore`.
```bash 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?
Conclusão principal Há três obstáculos mais comuns: o limite do GitHub de 60 pedidos por hora, a instalação bloqueada pela verificação de segurança e o ficheiro estar na pasta errada. Se atingir o limite de pedidos, adicione `GITHUB_TOKEN`. Se a verificação bloquear a instalação, leia o respetivo veredito. Se o Hermes não encontrar a skill, confirme se está em `~/.hermes/skills/`.
| Sintoma | Causa | O que fazer | |----|----|----| | Erros de limite de pedidos ao pesquisar ou instalar | Sem um token, o GitHub permite até 60 pedidos por hora | Adicione `GITHUB_TOKEN` a `~/.hermes/.env` | | Instalação bloqueada | A verificação detetou um risco no código da skill | Leia o resultado da verificação durante a instalação; para voltar a verificar uma skill instalada, execute `hermes skills audit`. Se for um aviso, pode continuar com `--force`; se o veredito for “dangerous”, não é possível | | Skill instalada, mas `/name` não funciona | O nome não corresponde ou a pasta está mal colocada | Execute `hermes skills list` e verifique a pasta `~/.hermes/skills/` | | A skill nem sequer aparece na lista | O SKILL.md tem uma restrição de plataforma ou de ferramentas necessárias | Abra o SKILL.md e verifique os campos `platforms` e `requires_*` | | A nova versão da skill não foi obtida após a atualização | Alterou o ficheiro localmente e o Hermes preserva as suas edições | Se precisar da versão original, use `update name --force` para uma skill do hub ou `reset --restore` para uma integrada; se a sua versão for mais importante, não faça nada | | As skills de outro repositório não carregam | O repositório tem de ser marcado como fidedigno | Execute `hermes skills trust` dentro do repositório | 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?
Conclusão principal Instale uma skill pronta do catálogo; a instalação demora apenas um comando. Depois, escolha uma instrução que repete, passe-a ao `/learn` e verifique o resultado numa tarefa real do seu trabalho.
A seguir, sobre este tema: [como ligar o Hermes Agent ao Telegram](https://ailoot.ai/blog/pt-pt/hermes-agent-telegram-setup/), para poder invocar skills a partir do telemóvel, e [como manter um agente em execução num servidor 24 horas por dia](https://ailoot.ai/blog/pt-pt/hermes-agent-vps-24-7/), se quiser skills agendadas. Se estiver a escolher um agente, consulte a comparação [OpenClaw ou Hermes Agent](https://ailoot.ai/blog/pt-pt/openclaw-vs-hermes-agent/).
### Fontes - [Documentação do Hermes Agent](https://hermes-agent.nousresearch.com/docs/) - [Sistema de Skills - como funcionam as skills](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) - [Criar Skills - como escrever a sua própria skill](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) - [Catálogo de skills integradas](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog) - [Skills opcionais oficiais](https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog) - [Repositório do Hermes Agent no GitHub](https://github.com/NousResearch/hermes-agent) - [Padrão aberto Agent Skills](https://agentskills.io/specification)
Pode continuar a explorar o Ailoot em [ailoot.ai](https://ailoot.ai/).
## Perguntas frequentes ### Porque não aparece uma skill instalada como comando de barra? Verifique lista de skills instaladas, nome SKILL.md e campo name e a pasta de skills do perfil ativo. Restrições de plataforma, ferramentas necessárias ou confiança do repositório também podem impedir o carregamento. ### O teste limitado só de skills verifica todas as dependências? Não. Verifica o carregamento e cumprimento da instrução. Verifique ferramentas, programas e chaves separadamente e confirme um resultado real delimitado antes de usar o método completo. ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.