Quando o Hermes Agent abriu ao público em 12 de março, a release veio com mais de setenta skills integrados em mais de quinze categorias. Quatro semanas depois, um marketplace de skills da comunidade estava no ar em agentskills.io com centenas a mais. Este post é sobre como isso aconteceu — e por que a arquitetura de skills do Hermes vale a pena entender mesmo que você nunca escreva um.
O que um skill realmente é
Na maioria dos frameworks de agentes de IA, uma "ferramenta" é uma função Python que o desenvolvedor registra no agente na hora do import. Você decora uma função, escreve uma docstring, lista num array de tools em algum lugar. Quando o agente precisa, o framework injeta a descrição no prompt e parseia a saída de chamada de ferramenta do modelo.
Um skill do Hermes não é isso. É um pacote declarativo com um manifesto (skill.yaml), um conjunto de scripts executáveis ou entrypoints Python, uma descrição dos pré-requisitos, e uma política de ativação. Quando o Hermes inicia, ele percorre o diretório de skills, lê cada manifesto e decide quais skills estão disponíveis pra essa sessão com base em se os pré-requisitos realmente existem na máquina — variáveis de ambiente, binários no PATH, entradas em arquivos de config, capacidades da plataforma.
Um skill que precisa de ffmpeg não será anunciado ao agente numa máquina que não tem ffmpeg instalado. Um skill que precisa de um token de bot do Telegram só ativa numa sessão conectada ao Telegram. O prompt do agente só carrega os skills que você de fato pode usar naquele momento.
Parece menor. É o motivo pelo qual um agente pode vir com setenta skills no dia um sem derreter o prompt.
O Skills Hub e o que ele faz
Embutido no Hermes desde a v0.2.0 existe algo chamado Skills Hub — um índice local de todo skill disponível nesta instalação, com metadados, atribuição de fonte e uma camada de ativação condicional. Dá pra rodar hermes skills list pra ver o que está instalado, hermes skills enable <nome> ou hermes skills disable <nome> pra ligar e desligar, e hermes skills info <nome> pra ver o manifesto, a fonte e os pré-requisitos exatos.
O Hub também é a abstração onde skills da comunidade se conectam. Um autor de skill publica manifesto + pacote fonte; usuários do Hermes instalam com um único comando; o Hub trata validação de pré-requisitos e regras de ativação do mesmo jeito que faz pros skills nativos. Não existe caminho especial pra skills "oficiais" versus "da comunidade" — são todos apenas skills.
Quatro semanas após o lançamento, esse Hub ganhou sua face pública: agentskills.io. É um diretório web de skills contribuídos pela comunidade com busca, categorias, métricas de popularidade e um comando de instalação padronizado. Pense nele como o npm ou pip de capacidades de agente, só que mais estreito: cada skill deve fazer uma coisa, e vem com um manifesto que diz ao Hermes como usá-lo com segurança.
Por que o ecossistema cresceu rápido
Quatro semanas não é muito tempo pra ir de zero a centenas de skills da comunidade. Algumas coisas na arquitetura tornaram isso possível.
O manifesto é a interface. Um autor de skill só precisa acertar o manifesto. Pré-requisitos, descrição, schema de entrada, condições de ativação — tudo vai no skill.yaml. A implementação pode ser Python, shell script, binário executável, qualquer coisa que o manifesto aponte. Contribuidores não precisam aprender um SDK específico do Hermes pra escrever um skill útil. Precisam descrever o que sua ferramenta faz num arquivo YAML que já existia pros skills nativos.
Pré-requisitos são estruturais, não documentados. Se um skill precisa de ffmpeg, o manifesto diz isso, e o Hermes verifica. Você não instala um skill quebrado que falha silenciosamente em runtime por falta de dependência — o Hub diz o que está faltando e recusa ativar. Isso significa que autores de skills podem presumir, e usuários podem confiar.
Ativação é condicional. Um skill pode declarar que só ativa no Telegram, só quando uma env var específica está definida, só quando um arquivo particular existe, só em certos diretórios de trabalho. O prompt que o agente vê é moldado pro momento. Dá pra instalar cem skills e o agente nunca vai ver noventa deles em qualquer sessão, o que significa que o prompt não incha.
Sandbox-friendly por padrão. Skills que executam código fazem dentro das camadas de sandbox existentes do Hermes — o isolamento por git worktree e o sistema de checkpoint de sistema de arquivos do lançamento v0.2.0. Um skill da comunidade que sai dos trilhos não consegue destruir seu código ou seus arquivos, porque o sandbox é embutido no agente, não no skill. Isso reduz drasticamente o custo de confiança de instalar algo novo.
Como são os skills típicos da comunidade
Skills da comunidade das primeiras quatro semanas se agrupam em alguns padrões úteis:
- •Wrappers de ferramentas CLI existentes. Alguém pega
ffmpeg,pandocouimagemagicke escreve um skill fino que expõe as operações comuns — cortar vídeo, converter documento, redimensionar imagem. Baratos de escrever e imediatamente úteis. - •Integrações com serviços pessoais. Skills que conversam com sua conta do Notion, vault do Obsidian, instância do Home Assistant, leitor de RSS, conta do Pocket ou app de finanças pessoais. A maioria são menos de 200 linhas de Python mais um manifesto.
- •Helpers de domínio específico. Skills sob medida pra workflows específicos — um skill de leitura de papers pra pesquisadores, um skill de resumo de git log pra leads de engenharia, um gerador de cardápio pra cozinheiros, um assistente de mestre pra grupos de RPG de mesa.
- •Shims específicos de modelo. Skills que adicionam recursos específicos do provedor (headers de cache de prompt, budgets de raciocínio, hooks de fine-tuning) como ferramentas formais do agente em vez de exigir código de cliente customizado.
Nenhum desses individualmente é uma killer feature. No conjunto, são o motivo pelo qual o Hermes parou de parecer "um negócio que a Nous Research construiu" e começou a parecer uma comunidade.
A consequência interessante
No dia em que o agentskills.io passou dos cem skills da comunidade, algo sutil mudou no projeto. Já não era possível descrever o que o Hermes Agent é listando suas features, porque o conjunto de features tinha se tornado ilimitado. O que dá pra descrever é a forma da coisa: um agente único, conversando com qualquer plataforma de chat que você quiser, puxando skills sob demanda, sob um modelo de segurança uniforme.
Isso não é uma lista de features. É uma plataforma. E é o motivo pelo qual o ecossistema de skills importa mais do que qualquer capacidade individual que vem dentro dele.