O que são as habilidades do Hermes Agent e quais são seus principais componentes?

As habilidades do Hermes Agent são pacotes de recursos reutilizáveis que ensinam o agente a realizar tarefas específicas nas áreas de programação, pesquisa, produtividade, mídia, DevOps, segurança e outros fluxos de trabalho.

Em vez de depender apenas de prompts pontuais, o Hermes utiliza habilidades como instruções e recursos reutilizáveis. Uma habilidade pode definir o que ela faz, quando deve ser usada, quais configurações são necessárias, de quais ferramentas ou credenciais ela depende e quais arquivos de apoio ajudam o agente a concluir a tarefa.

Os principais componentes de uma habilidade do Hermes Agent:

• Arquivo SKILL.md. O arquivo Markdown principal que define a habilidade, incluindo sua finalidade, instruções, notas de configuração, orientações de uso e quaisquer restrições importantes.
• Frontmatter YAML. O bloco de metadados que identifica a skill declara campos como nome, descrição, versão, autor, variáveis de ambiente necessárias e arquivos de credenciais necessários.
• Diretório de habilidades. A pasta que contém a definição da habilidade e os arquivos de apoio. As habilidades incluídas no pacote são copiadas para ~/.hermes/skills/ durante a instalação, enquanto as habilidades opcionais ficam na pasta optional-skills/ até serem instaladas.
• Arquivos de apoio. Recursos adicionais, como referências/, templates/ e scripts/, que fornecem contexto reutilizável, exemplos, recursos ou código auxiliar.

Como funcionam as habilidades do Hermes Agent

As habilidades do Hermes Agent funcionam fornecendo ao agente instruções reutilizáveis de fluxo de trabalho para tarefas específicas.

Cada habilidade é definida por um arquivo SKILL.md obrigatório. Esse arquivo explica o que a habilidade faz, quando usá-la, as etapas que o agente deve seguir e como verificar o resultado.

Uma habilidade também pode incluir arquivos complementares, como scripts auxiliares, referências e templates.

As habilidades incluídas no pacote vêm com o Hermes e são copiadas para ~/.hermes/skills/ durante a instalação.

O Hermes Agent sincroniza essas habilidades agrupadas durante a atualização do Hermes, respeitando as exclusões locais e as edições feitas pelo usuário.

Se uma habilidade incluída no pacote não estiver presente na árvore de habilidades local, você pode restaurá-la com o comando hermes skills reset <nome> --restore.

As habilidades opcionais são fornecidas na pasta optional-skills/ e não estão ativas por padrão.

Os usuários realizam a instalação explicitamente com comandos como hermes skills install official/blockchain/solana ou hermes skills install official/mlops/flash-attention, e removem as skills com hermes skills uninstall <nome-da-skill>.

Quando disponível, uma habilidade fornece ao Hermes um contexto de tarefa reutilizável. Ela não substitui o modelo nem as ferramentas principais do Hermes.

Em vez disso, ele informa ao agente qual fluxo de trabalho deve ser seguido, quais ferramentas existentes ou comandos de shell devem ser usados, quais arquivos de apoio estão disponíveis e qual configuração a tarefa requer.

Principais componentes das habilidades do Hermes Agent

Uma habilidade do Hermes Agent é construída em torno de um arquivo SKILL.md e também pode incluir metadados, requisitos de configuração, arquivos de apoio e código auxiliar.

Definição de SKILL.md

O arquivo SKILL.md é o principal arquivo de instruções para uma habilidade do Hermes Agent.

Um bom SKILL.md começa com o fluxo de trabalho mais comum e apresenta os casos mais avançados mais adiante no arquivo. Isso mantém a skill prática durante o uso normal, ao mesmo tempo em que fornece ao Hermes detalhes suficientes para casos excepcionais.

Por exemplo, uma habilidade de fluxo de trabalho de PR do GitHub pode explicar como criar um branch, fazer alterações, abrir um pull request, verificar os resultados da integração contínua e preparar a transferência de responsabilidade. O Hermes pode reutilizar esse processo sempre que surgir o mesmo tipo de tarefa.

Frontmatter do YAML

O frontmatter do YAML fornece ao Hermes informações estruturadas sobre a skill antes do início das instruções principais.

O bloco de metadados identifica a habilidade, descreve em que contexto ela se encaixa e informa ao Hermes quais condições ou requisitos de configuração afetam o uso da habilidade.

No nível básico, a seção introdutória pode definir campos como o nome, a descrição, a versão, o autor e a licença da skill. Esses campos tornam a skill identificável e ajudam os usuários a entender o que ela faz antes de abrirem a definição completa.

O Frontmatter permite controlar quando o Hermes deve exibir a skill. Por exemplo, uma skill pode usar plataformas para se limitar ao macOS, ao Linux ou ao Windows. Uma skill também pode declarar ferramentas ou conjuntos de ferramentas necessários, como ferramentas da web, ou atuar como alternativa quando uma ferramenta principal não estiver disponível.

Os requisitos de configuração também devem constar na seção “frontmatter”. As habilidades podem declarar variáveis de ambiente necessárias para segredos, como chaves de API, arquivos de credenciais necessários para tokens OAuth ou arquivos de contas de serviço, além de configurações para valores não confidenciais, como caminhos de arquivos, domínios ou preferências do usuário.

A seção de cabeçalho torna uma skill mais do que apenas um arquivo de prompt. Os metadados ajudam o Hermes a identificar a skill, carregá-la apenas no ambiente correto e preparar o contexto de que o agente precisa para executar o fluxo de trabalho corretamente.

Diretório de habilidades

O diretório de habilidades é a pasta que contém uma habilidade do Hermes Agent e todos os seus recursos de apoio.

Um diretório típico de skill inclui um arquivo obrigatório SKILL.md e também pode conter subdiretórios como scripts/, references/ e templates/. O conteúdo exato depende do fluxo de trabalho que a skill suporta.

As habilidades incluídas no pacote vêm junto com o Hermes e estão organizadas em categorias como pesquisa, produtividade, desenvolvimento de software, mídia e DevOps. Durante a instalação, o Hermes copia as habilidades incluídas no pacote para ~/.hermes/skills/, disponibilizando-as no ambiente local do usuário.

As habilidades opcionais utilizam a mesma estrutura de diretórios, mas ficam localizadas em optional-skills/ até que um usuário as instale. Por exemplo, o Hermes inclui habilidades opcionais para fluxos de trabalho com blockchain, modelagem financeira, operações de aprendizado de máquina e desenvolvimento web, que os usuários podem adicionar somente quando necessário.

Uma estrutura de diretórios consistente torna as habilidades transferíveis e fáceis de compartilhar. Os desenvolvedores podem agrupar instruções, scripts auxiliares, materiais de referência e requisitos de configuração, em vez de distribuir os componentes do fluxo de trabalho por vários locais.

Arquivos de apoio e scripts auxiliares

Os arquivos de apoio e os scripts auxiliares fornecem recursos reutilizáveis para as Habilidades do Hermes Agent, além das instruções principais do arquivo SKILL.md.

Uma habilidade pode incluir referências/ para material de referência, templates/ para formatos de saída repetíveis e scripts/ para código auxiliar.

Os scripts são úteis quando um fluxo de trabalho requer análise, formatação, extração de dados ou outra lógica que não deva ser reescrita no prompt todas as vezes.

O Hermes expõe o caminho do diretório da skill quando ela é carregada; assim, as instruções no arquivo SKILL.md podem direcionar o agente diretamente aos scripts incluídos no pacote.

Por exemplo, uma skill pode instruir o Hermes a executar um script auxiliar localizado em ${HERMES_SKILL_DIR}/scripts/, em vez de fazer com que o agente recrie essa lógica do zero.

Os arquivos de apoio mantêm as habilidades em um formato prático. O fluxo de trabalho permanece legível no arquivo SKILL.md, enquanto o código reutilizável, os exemplos e o material de referência ficam organizados dentro do diretório da habilidade.

Habilidades do Hermes Agent: incluídas no pacote x opcionais

Os recursos integrados ao Hermes são fornecidos porque dão suporte a fluxos de trabalho comuns de que muitos usuários precisam, como gerenciamento do GitHub, pesquisa, produtividade, anotações e desenvolvimento de software.

As habilidades opcionais abrangem fluxos de trabalho especializados, integrações e ferramentas úteis para um grupo menor de usuários.

A tabela a seguir apresenta exemplos de ambos os grupos:

Como realizar a instalação das Habilidades do Hermes Agent

Depois de concluir a configuração inicial do Hermes Agent, você pode instalar habilidades opcionais com o comando hermes skills install.

1. Identifique a habilidade que você deseja realizar a instalação

As habilidades incluídas no pacote não precisam passar pela etapa de instalação, pois o Hermes as copia para ~/.hermes/skills/ durante a configuração.

As habilidades oficiais opcionais utilizam identificadores baseados em categorias. Por exemplo, a habilidade Solana usa official/blockchain/solana, enquanto a habilidade DuckDuckGo Search usa official/research/duckduckgo-search.

2. Execute o comando de instalação

Passe o identificador completo da habilidade para hermes skills install.

hermes skills install official/blockchain/solana

Hermes baixa a habilidade e a adiciona à biblioteca local de habilidades.

3. Conclua todas as configurações necessárias

Algumas habilidades exigem configuração adicional antes de poderem ser utilizadas plenamente. Dependendo da habilidade, o Hermes pode solicitar variáveis de ambiente, chaves de API, credenciais OAuth, arquivos de credenciais ou configurações declaradas nos metadados da habilidade.

4. Use a habilidade instalada

Após a instalação, o Hermes pode acessar as instruções do SKILL.md da skill, seus metadados, scripts auxiliares e arquivos de suporte.

A habilidade fica disponível junto com as habilidades incluídas que já estão instaladas no sistema.

5. Remova a habilidade quando ela não for mais necessária

Use hermes skills uninstall para remover uma habilidade instalada da biblioteca local de habilidades.

Exemplo:

hermes skills uninstall solana

Isso remove uma habilidade sem afetar as outras habilidades instaladas.

Como as habilidades do Hermes Agent utilizam credenciais

As habilidades do Hermes Agent utilizam credenciais por meio de requisitos de configuração declarados, em vez de segredos codificados de forma estática.

As habilidades utilizam required_environment_variables para chaves de API, tokens e outros valores de cadeias de caracteres confidenciais.

Quando uma habilidade precisa de uma variável, como uma chave de API, o Hermes solicita essa informação ao usuário de forma segura durante a configuração. O Hermes não expõe o valor bruto do segredo ao modelo.

As habilidades utilizam required_credential_files para credenciais armazenadas como arquivos.

Tokens OAuth, segredos de cliente, arquivos JSON de contas de serviço e certificados devem ser armazenados em arquivos de credenciais, e não em variáveis de ambiente. Quando esses arquivos existem, o Hermes os disponibiliza para ambientes locais, no Docker ou em sandboxes remotas, conforme necessário.

O repasse de credenciais permite que os scripts de uma skill acessem segredos aprovados durante a execução. Por exemplo, um script auxiliar em Python pode ler uma chave de API permitida a partir de os.environ sem que o usuário precise configurar o mesmo valor novamente para cada sandbox.

Casos de uso das habilidades do Hermes Agent

Para usuários que trabalham com casos de uso mais amplos do Hermes Agent, as habilidades transformam tarefas repetitivas em fluxos de trabalho reutilizáveis que o Hermes pode carregar, acompanhar e aprimorar ao longo do tempo.

Entre os casos de uso mais comuns estão:

• Fluxos de trabalho de pesquisa – pesquisa de artigos no arXiv, acompanhamento de blogs, consulta a mercados de previsão e transformação de transcrições do YouTube em resumos.
• Fluxos de trabalho de desenvolvimento de software – revisão de pull requests no GitHub, elaboração de planos de implementação, depuração de código em Python ou Node.js e desenvolvimento orientado a testes.
• Fluxos de trabalho de produtividade – trabalho com o Google Workspace, Notion, Airtable, PDFs, OCR, mapas e apresentações de slides.
• Fluxos de trabalho de mídia – pesquisa de GIFs, gerenciamento de filas e reprodução no Spotify, análise de características de áudio e criação de resumos de conteúdo do YouTube.
• Fluxos de trabalho de DevOps – gerenciamento de assinaturas de webhooks, contêineres Docker, trabalhadores Kanban e túneis de serviço locais.
• Fluxos de trabalho de MLOps – utilizando o Hugging Face Hub, executando inferência local com o llama.cpp, disponibilizando modelos com o vLLM e avaliando modelos de linguagem.
• Fluxos de trabalho criativos – geração de diagramas de arquitetura, esboços no Excalidraw, pixel art, quadrinhos, infográficos e vídeos no Manim.

Como escolher a habilidade certa do Hermes Agent

Escolha a habilidade correta do Hermes Agent, associando sua tarefa à categoria de fluxo de trabalho compatível com essa habilidade.

Como gerenciar as habilidades do Hermes Agent em grande escala

Gerenciar as habilidades do Hermes Agent em grande escala significa manter as habilidades, credenciais, atualizações e fluxos de trabalho de longa duração consistentes e disponíveis para uso repetido.

A configuração de um VPS é a escolha certa quando o Hermes Agent precisa permanecer disponível independentemente de uma máquina local, especialmente para tarefas agendadas, integrações de mensagens e fluxos de trabalho que dependem de memória persistente ou Habilidades do Hermes Agent.

A implantação do Hermes Agent com um clique da Hostinger oferece suporte a essa configuração com uma instalação pré-configurada, gerenciamento do Docker, backups automáticos e recursos VPS dedicados.

Para equipes ou usuários avançados, isso facilita a manutenção de fluxos de trabalho baseados em habilidades, pois o Hermes pode continuar em execução, atualizando-se e utilizando suas habilidades configuradas sem depender de um computador pessoal que permaneça conectado à internet.

Todo o conteúdo dos tutoriais deste site segue os rigorosos padrões editoriais e valores da Hostinger.

O autor

Ana Paula

Ana é formada em Línguas Estrangeiras Aplicadas às Negociações Internacionais pela Universidade Estadual de Santa Cruz, na Bahia. Atualmente atua como tradutora após 3 anos na equipe de Customer Success da Hostinger, completando 5 anos de empresa em 2026. Interessada por tecnologia, viagens, cinema e culinária.

Mais de Ana Paula