Hermes Agent: como instalar e criar sua primeira skill, sem explicar a tarefa toda segunda-feira

Toda segunda-feira você abre o chat e explica a mesma tarefa para a IA. Na segunda seguinte, explica de novo.

O Hermes Agent tenta resolver esse ponto. Você ensina a tarefa uma vez, ele guarda o procedimento como uma skill e, nas semanas seguintes, você chama a skill em vez de explicar tudo outra vez.

Este guia é o passo a passo básico: o link oficial, um prompt para o Claude guiar a instalação e os comandos para começar. Se você chegou pelo meu Reel, é a continuação dele.

O que é o Hermes Agent

É um agente de código aberto da Nous Research. Ele não é um modelo novo como o GPT ou o Claude. É a estrutura em volta do modelo: o modelo lê e planeja, as ferramentas agem e a memória guarda o que foi feito.

Segundo o projeto, ele cria skills a partir da experiência. Uma skill é um arquivo com o nome, quando usar e o passo a passo de uma tarefa. O agente só carrega o arquivo quando a tarefa pede.

Aprender, aqui, não é retreinar o modelo. O que muda são os manuais que ele consulta.

Antes de começar

1. Saiba onde fica o terminal. No Mac, é o app Terminal. No Windows, o PowerShell. Se você nunca abriu um, o prompt do passo 1 explica.
2. Tenha um modelo para o Hermes usar. Pode ser uma conta na Nous Portal ou uma chave de API de outro provedor. A documentação pede um modelo com pelo menos 64 mil tokens de contexto.
3. Escolha uma tarefa que você repete. Uma por enquanto. O passo 3 usa ela.

Passo 1: instalar

Se você usa o Claude, deixe que ele guie. Cole o prompt abaixo, troque os campos entre colchetes e siga um passo de cada vez.

Quero instalar o Hermes Agent, o agente de código aberto da Nous Research (github.com/NousResearch/hermes-agent). Use só a documentação oficial: hermes-agent.nousresearch.com/docs/getting-started/quickstart.

Meu sistema: [macOS / Windows / Linux]. Meu nível: [nunca usei o terminal / uso o terminal às vezes].

Me guie em passos curtos, um de cada vez:
1. Me diga como abrir o terminal no meu sistema.
2. Me dê o comando de instalação oficial para o meu sistema e explique em 2 linhas o que ele faz antes de eu rodar.
3. Me diga como conferir se deu certo (comando de verificação e o que devo ver na tela).
4. Me ajude a rodar o assistente de configuração (hermes setup) e a escolher um modelo.

Regras: não invente comandos. Se não tiver certeza de um comando, diga e me mande conferir na documentação. Nunca me peça para colar chaves de API ou senhas aqui: me diga onde digitá-las no próprio terminal. Se aparecer um erro, me peça a mensagem inteira antes de sugerir qualquer coisa.

Se preferir instalar sozinho, a documentação oficial traz um comando por sistema.

No Mac, Linux e WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

No Windows, no PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Depois, feche e abra o terminal (ou rode source ~/.zshrc) e digite:

hermes

Se o chat abrir, a instalação deu certo. Se algo falhar, rode hermes doctor: ele confere a configuração e as dependências.

Passo 2: configurar o modelo

Na primeira vez, rode:

hermes setup

O assistente pergunta como você quer configurar. Se você não quer juntar várias chaves de API, o projeto oferece o caminho da Nous Portal, com hermes setup --portal. Para trocar de modelo depois, usehermes model.

As chaves ficam no arquivo ~/.hermes/.env. Digite no terminal, nunca em chat, e nunca publique esse arquivo.

Passo 3: a primeira skill

A sequência é sempre a mesma: ensinar, corrigir, guardar.

Ensine a tarefa

Abra o hermes e cole o prompt 2. Ele faz o Hermes perguntar o que importa antes de executar, e não depois.

Vou te ensinar uma tarefa que eu repito toda [segunda-feira]: [descreva a tarefa em 1 frase, por exemplo: juntar as notícias de IA da semana em um resumo de 10 linhas].

Antes de executar, me faça até 5 perguntas, uma por vez: onde você deve buscar, o que deve descartar, o formato da entrega e o que seria um resultado ruim.

Depois de eu responder, execute a tarefa uma vez e me mostre o resultado. Eu vou corrigir o que estiver errado.

Corrija o resultado

Leia o que ele entregou e diga o que está errado. "Tirou o jornal errado", "o resumo ficou longo". Essas correções são o conteúdo da skill. Quanto mais específicas, melhor o manual.

Guarde como skill

Quando o resultado estiver bom, peça para guardar.

Transforme o que fizemos agora em uma skill reutilizável chamada [nome-da-skill]. Inclua:
- quando usar a skill
- os passos, na ordem
- as minhas correções (o que descartar, o formato, o que evitar)

Salve a skill e me diga o nome e o local do arquivo. Na próxima vez, vou chamar com /[nome-da-skill].

Confira com hermes skills list se a skill apareceu. Na semana seguinte, abra o Hermes e chame pelo nome com uma barra, por exemplo /resumo-ia.

Comandos para começar

No terminal:

• hermes: abre o chat
• hermes --tui: abre a interface de terminal mais nova
• hermes setup: assistente de configuração
• hermes model: escolhe o provedor e o modelo
• hermes doctor: checa a configuração e as dependências
• hermes --continue: retoma a última conversa
• hermes skills list: lista as skills instaladas
• hermes skills browse e hermes skills search [tema]: procuram skills prontas

Dentro do chat:

• /help: lista os comandos
• /tools: lista as ferramentas disponíveis
• /skills: mostra as skills
• /model: troca de modelo
• /new: começa uma conversa nova
• /retry e /undo: refazem ou desfazem o último turno
• /usage: mostra o consumo

Cuidados

• Skills de terceiros. O comando hermes skills install baixa skills de outras pessoas. O Hermes faz uma verificação de segurança antes, mas leia o que vai instalar.
• Agente age. Diferente de um chat, o Hermes usa ferramentas e pode mexer em arquivos. Comece com tarefas pequenas, numa pasta de teste.
• Confira a primeira execução. Antes de confiar numa skill, rode e compare com o que você faria à mão.

Explique uma vez. Confira sempre.