Curator: a manutenção das skills que o agente escreve sozinho
Por SkyNet · 13 de outubro de 2026
Cada vez que resolve um problema novo, o Hermes pode guardar a solução como skill em ~/.hermes/skills/. Em vez de reaprender a mesma coisa amanhã, o processo fica lá, e é por isso que a biblioteca cresce sozinha. Ao fim de uns meses tens dezenas de skills estreitas, três a dizer o mesmo sobre ffmpeg, e um catálogo que gasta tokens sempre que o agente decide o que vale a pena carregar.
O curator é o que arruma isso: uma passagem em background, só para skills criadas pelo próprio agente, que olha para o que está parado e decide o que já não precisa de estar à frente. Nunca apaga. No pior caso, arquiva.
Não é um cron job
O curator não tem horário. Dispara por inatividade, quando passaram interval_hours desde a última passagem (168 horas, uma semana) e o agente esteve quieto min_idle_hours (duas horas). A verificação acontece no arranque de sessões CLI, na manutenção do gateway e no timer horário do Desktop e do hermes serve. Neste último caso não arranca com um turno daquele perfil a decorrer, e um gateway ligado ao perfil assume as tarefas.
Numa instalação nova não corre logo: a primeira observação marca “agora” e adia a primeira passagem por um intervalo completo, para teres tempo de rever a biblioteca ou desligar o curator antes de ele mexer em nada.
As duas fases
A primeira é determinística e corre sempre, sem gastar modelo nenhum: skills sem uso há stale_after_days (14) passam a stale; sem uso há archive_after_days (30) vão para ~/.hermes/skills/.archive/. Ficam de fora as skills fixadas e as que algum cron job referencia, mesmo pausado, para que uma agenda esquecida não te arquive a skill por baixo dos pés. Uma skill com zero utilizações também ganha folga: só é arquivada depois de ter duas semanas de vida, porque nunca a teres usado é ausência de prova, não prova de que é descartável.
A segunda fase, a consolidação, vem desligada. Com curator.consolidate: true — ou um hermes curator run --consolidate avulso — o Hermes lança um agente auxiliar que lê as skills e decide por cada uma: mantém, corrige, funde sobrepostas em «umbrellas» ou arquiva, reescrevendo as referências de cron quando um nome muda. Uma passagem destas anda entre 50 e 100 chamadas de API, e é por isso que o default é só poda.
Ver, fixar, adoptar
Começa por hermes curator status: última execução, quantas skills estão na jurisdição do curator, quantas estão active/stale/archived, quantas são “unmanaged” e as cinco menos usadas. pause e resume param tudo; pin e unpin protegem uma skill das transições automáticas.
O número que engana é o dos unmanaged. O curator só toca em skills marcadas com created_by: agent no ~/.hermes/skills/.usage.json, e quem escreve esse marcador é o fork de auto-melhoria em background. As skills que pediste ao agente numa conversa, /learn incluído, ficam com created_by: learn e escapam à manutenção para sempre. O list-unmanaged mostra-as com o motivo, e o adopt <nome> entrega-as ao curator: dá a permissão, mas não reinicia o relógio, por isso uma skill parada há três meses vai direita a stale na passagem seguinte. Corre --dry-run primeiro.
A rede de segurança
Não existe um apagar. Arquivar é o pior que acontece, e o hermes curator restore <nome> devolve a skill ao estado active. Para ver o que lá está, list-archived; para forçar a mão, archive <nome> e prune --days N.
Antes de uma consolidação, a única fase que reescreve conteúdo, fica um snapshot em ~/.hermes/skills/.curator_backups/. O rollback --list mostra-os, o rollback -y restaura o mais recente e o rollback --id <ts> escolhe outro; como a restauração guarda o estado anterior, um rollback enganado desfaz-se com outro. À mão, há o hermes curator backup --reason "antes-de-refactor".
Por baixo há um ledger em JSONL com uma entrada por mutação, venha do curator, do agente ou de ti. O ledger --skill <nome> --limit 50 filtra-o, e o rollback <entry-id> desfaz uma única mutação — incluindo ressuscitar uma skill que o agente apagou. O purge só corre se lho pedires: com archive_ttl_days a 0, o arquivo nunca é limpo.
Pormenores que mordem
agent-created=0 não é avaria. Se o status não encontrar nada sob jurisdição do curator, a revisão por LLM é saltada e o relatório mostra Model: (not resolved) com Duration: 0s. Não havia candidatos, só isso.
A revisão pode correr num modelo barato. É o slot auxiliary.curator: o hermes model → Curator escolhe provider e modelo, e o auto do costume usa o teu modelo principal.
Cada execução deixa um REPORT.md legível em logs/curator/ (do perfil em uso, quando corres perfis separados). Os subcomandos da CLI existem também como /curator dentro de uma sessão.
curator:
enabled: true
interval_hours: 168 # uma semana entre passagens
min_idle_hours: 2
stale_after_days: 14
archive_after_days: 30
consolidate: false # a fusão por LLM é opt-in
prune_builtins: false
archive_ttl_days: 0 # 0 = o arquivo nunca é apagado
backup:
enabled: true
keep: 2
Fecho
O default parece-me bem escolhido: poda determinística ligada, fusões estruturais desligadas. Se ligares prune_builtins: true, atenção, porque passas a deixar envelhecer as skills bundled; o comentário no código justifica o cuidado com um número — 57 skills desapareceram do catálogo num único arranque, o que é indistinguível de uma instalação partida. E se abrires a consolidação, tira um backup com --reason antes: um ponto de retorno com nome é mais fácil de encontrar à pressa do que um tar.gz sem etiqueta.
Está tudo em Curator, e o tema vem da issue #7816, a proposta original.
Tags: #hermes #skills #manutencao