Guia de Skills do Hermes Agent

Esta nota complementa Guia básico do Hermes Agent na trilha IA. Para explorar o ecossistema mais amplo de ferramentas de IA, consulte Altern.AI.

Versão: 1.0
Data: 2026-05-17
Foco: Ubuntu/Linux, uso prático, instalação e seleção de skills úteis.

1. O que são skills no Hermes?

No Hermes, skills são pacotes de conhecimento e procedimento que ensinam o agente a fazer tarefas específicas.

Pense nelas como “manuais operacionais acionáveis”:

uma skill pode ensinar o Hermes a revisar PRs no GitHub;
outra pode ensinar a criar diagramas;
outra pode ensinar a usar Google Workspace;
outra pode ensinar um fluxo interno seu, como “gerar relatório semanal da empresa”.

A sacada boa é que o Hermes não carrega tudo o tempo inteiro. Ele usa progressive disclosure:

vê uma lista compacta das skills disponíveis;
abre a skill completa só quando precisa;
abre arquivos auxiliares da skill só se forem necessários.

Isso economiza contexto e evita que o agente fique “inchado”.

2. Onde as skills ficam no Linux/Ubuntu?

Diretório principal:

~/.hermes/skills/

Esse é o diretório local e principal.

Skills instaladas via Hub, skills criadas pelo próprio agente e skills que vêm junto com o Hermes acabam nesse ecossistema.

3. Tipos de skills

3.1 Bundled skills

São skills que já vêm com o Hermes.

Elas são copiadas para:

~/.hermes/skills/

na instalação ou atualização.

Exemplos:

plan
arxiv
github-pr-workflow
google-workspace
obsidian
notion
youtube-content
systematic-debugging
test-driven-development

3.2 Optional skills

São skills oficiais, mas não vêm ativas por padrão.

Você instala manualmente:

hermes skills install official/<categoria>/<skill>

Exemplo:

hermes skills install official/mlops/axolotl
hermes skills install official/security/1password
hermes skills install official/research/duckduckgo-search

3.3 Community / Hub skills

São skills vindas de registries externos, como skills.sh, repositórios GitHub, endpoints .well-known, ClawHub etc.

Exemplo genérico:

hermes skills search react --source skills-sh
hermes skills inspect skills-sh/vercel-labs/agent-skills/vercel-react-best-practices
hermes skills install skills-sh/vercel-labs/agent-skills/vercel-react-best-practices

Use com mais cuidado. Skill de terceiros pode conter instruções ruins, perigosas ou simplesmente porcaria.

4. Comandos essenciais

Listar skills instaladas

Dentro do chat:

/skills

Via terminal:

hermes skills list

Buscar skills

Dentro do chat:

/skills search docker
/skills search github
/skills search research

Via terminal:

hermes skills search docker
hermes skills search github
hermes skills search research

Navegar pelo Hub

hermes skills browse

Somente skills oficiais opcionais:

hermes skills browse --source official

Inspecionar antes de instalar

hermes skills inspect official/security/1password

Para community skills, isso é obrigatório na prática. Não instale às cegas.

Instalar skill

hermes skills install official/security/1password

Atualizar skills instaladas pelo Hub

hermes skills check
hermes skills update

Auditar skills

hermes skills audit

Remover skill

hermes skills uninstall <nome-da-skill>

Restaurar uma bundled skill

Se você quebrou/editou uma skill bundled e quer voltar para a versão original:

hermes skills reset <nome-da-skill> --restore

Exemplo:

hermes skills reset google-workspace --restore

5. Principais bundled skills por categoria

Abaixo estão as skills mais úteis para uso real. Não é uma lista de todas; é a lista que vale seu tempo primeiro.

5.1 Planejamento e execução de trabalho

`plan`

Para que serve: cria planos de implementação em Markdown, sem sair executando comandos.

Use quando você quer que o Hermes pense antes de agir.

Exemplo:

/plan planeje a migração do meu app Flask para FastAPI

Boa para:

planejar features;
quebrar tarefas grandes;
evitar que o agente saia fazendo besteira;
documentar decisões.

Minha recomendação: use plan antes de qualquer tarefa grande.

`writing-plans`

Para que serve: escrever planos de implementação com tarefas menores, caminhos de arquivos e sequência de execução.

Boa para:

projetos de código;
refatorações;
tarefas de engenharia;
instruções para outro agente ou para você mesmo.

`spike`

Para que serve: validar uma ideia rapidamente antes de transformar em projeto.

Boa para:

testar bibliotecas;
fazer provas de conceito;
confirmar se uma abordagem técnica é viável;
matar ideias ruins cedo.

5.2 Desenvolvimento de software

`systematic-debugging`

Para que serve: depuração em fases, procurando causa raiz antes de tentar consertar.

Use quando o erro é confuso.

Exemplo:

/systematic-debugging meu script Python quebra com erro intermitente, investigue antes de corrigir

Boa para:

bugs difíceis;
erro intermitente;
sistemas com muitos componentes;
evitar “tentativa e erro” burra.

`test-driven-development`

Para que serve: força o ciclo RED-GREEN-REFACTOR: primeiro teste, depois implementação, depois limpeza.

Boa para:

código crítico;
APIs;
funções de negócio;
refatorações com segurança.

`requesting-code-review`

Para que serve: revisão pré-commit com foco em segurança, qualidade e correções automáticas.

Boa para:

revisar antes de subir PR;
encontrar falhas óbvias;
pegar problemas de qualidade;
evitar vergonha no GitHub.

`python-debugpy`

Para que serve: depurar Python com pdb, debugpy e fluxo DAP.

Boa para:

scripts Python;
APIs;
jobs;
automações.

`node-inspect-debugger`

Para que serve: depurar Node.js usando --inspect e protocolo do Chrome DevTools.

Boa para:

apps Node;
servidores Express/Nest;
scripts JS;
debugging de runtime.

5.3 GitHub

`github-auth`

Para que serve: configurar autenticação GitHub com tokens HTTPS, SSH keys e gh CLI.

Use primeiro se o Hermes ainda não consegue mexer no GitHub.

`github-pr-workflow`

Para que serve: ciclo completo de PR: branch, commit, abrir PR, acompanhar CI e merge.

Boa para:

automatizar tarefas de desenvolvimento;
criar PRs pequenos;
manter fluxo de Git limpo.

Exemplo:

/github-pr-workflow crie uma branch, implemente a correção e abra um PR

`github-code-review`

Para que serve: revisar PRs, diffs e comentar usando gh ou REST API.

Boa para:

revisar PR seu;
revisar PR de terceiro;
criar comentários inline;
detectar regressões.

`github-issues`

Para que serve: criar, triagear, rotular e atribuir issues.

Boa para:

organizar backlog;
transformar bugs em tarefas;
registrar decisões.

`github-repo-management`

Para que serve: clonar, criar, forkar repositórios, gerenciar remotes e releases.

Boa para:

setup de projeto;
manutenção de repositórios;
automação de releases.

5.4 Pesquisa e conhecimento

`arxiv`

Para que serve: pesquisar e recuperar papers acadêmicos do arXiv.

Boa para:

IA;
machine learning;
ciência da computação;
revisão de literatura.

Exemplo:

/arxiv encontre papers recentes sobre RAG com reranking

`llm-wiki`

Para que serve: construir e consultar uma base de conhecimento em Markdown interligada, inspirada no LLM Wiki do Karpathy.

Boa para:

notas técnicas;
pesquisa contínua;
organização de conhecimento.

`research-paper-writing`

Para que serve: apoiar escrita de papers de ML no estilo NeurIPS/ICML/ICLR.

Boa para:

estruturar paper;
organizar experimento;
montar narrativa técnica;
revisar seções.

`blogwatcher`

Para que serve: monitorar blogs e feeds RSS/Atom.

Boa para:

acompanhar pesquisa;
acompanhar concorrentes;
acompanhar lançamentos técnicos;
criar radar de notícias.

5.5 Produtividade

`google-workspace`

Para que serve: Gmail, Calendar, Drive, Docs e Sheets via gws CLI ou Python.

Boa para:

procurar e-mails;
mexer em docs;
consultar agenda;
automatizar planilhas;
trabalhar com Drive.

Instale/configure com cuidado porque envolve dados sensíveis.

`notion`

Para que serve: trabalhar com Notion API e ntn CLI: páginas, databases, Markdown e Workers.

Boa para:

base de conhecimento;
tarefas;
documentação;
CRM simples;
gestão pessoal.

`obsidian`

Para que serve: ler, buscar, criar e editar notas em um vault Obsidian.

Boa para:

PKM;
pesquisa pessoal;
diário técnico;
notas de projetos.

`linear`

Para que serve: gerenciar issues, projetos e times no Linear via GraphQL/curl.

Boa para:

times de produto;
gestão de roadmap;
bugs;
sprint planning.

`airtable`

Para que serve: CRUD de registros Airtable via REST API.

Boa para:

bancos simples;
CRM;
inventário;
automações administrativas.

`maps`

Para que serve: geocodificação, POIs, rotas e fusos via OpenStreetMap/OSRM.

Boa para:

logística;
pesquisa local;
rotas;
automações com endereço.

`nano-pdf`

Para que serve: editar texto, títulos e pequenos erros em PDFs via prompt natural.

Boa para:

ajustes rápidos;
correções simples;
edição pontual.

Não espere milagre em PDF complexo.

`ocr-and-documents`

Para que serve: extrair texto de PDFs e scans usando ferramentas como PyMuPDF e Marker PDF.

Boa para:

digitalização;
leitura de contratos;
documentos escaneados;
transformar PDF em texto útil.

`powerpoint`

Para que serve: criar, ler e editar apresentações .pptx.

Boa para:

decks internos;
slides de reunião;
apresentações de projeto.

5.6 Mídia e conteúdo

`youtube-content`

Para que serve: transformar transcrições do YouTube em resumos, threads e posts.

Boa para:

estudar vídeos longos;
transformar aula em notas;
criar conteúdo derivado.

`spotify`

Para que serve: pesquisar, tocar, enfileirar músicas e gerenciar playlists/dispositivos.

Boa para:

uso pessoal;
automações de mídia;
playlists.

`gif-search`

Para que serve: buscar e baixar GIFs do Tenor com curl e jq.

Boa para:

conteúdo leve;
posts;
mensagens.

`songwriting-and-ai-music`

Para que serve: composição musical e prompts para Suno.

Boa para:

letra;
estrutura de música;
prompt musical.

`songsee`

Para que serve: gerar espectrogramas e extrair features de áudio, como mel, chroma e MFCC.

Boa para:

análise musical;
áudio;
ML com som.

5.7 Criatividade e visual

`architecture-diagram`

Para que serve: criar diagramas SVG/HTML de arquitetura, cloud e infraestrutura.

Boa para:

arquitetura de sistemas;
documentação técnica;
explicar infra.

`excalidraw`

Para que serve: gerar diagramas estilo desenhado à mão em JSON do Excalidraw.

Boa para:

fluxos;
arquitetura;
sequência;
brainstorming.

`claude-design`

Para que serve: gerar artefatos HTML de design, landing pages, decks e protótipos.

Boa para:

prototipagem rápida;
layouts;
interfaces.

`sketch`

Para que serve: criar mockups HTML descartáveis com 2–3 variantes.

Boa para:

comparar ideias visuais;
rascunhos rápidos;
validar direção estética.

`popular-web-designs`

Para que serve: usar referências de design systems reais, como Stripe, Linear e Vercel, em HTML/CSS.

Boa para:

landing pages;
dashboards;
estética SaaS.

`comfyui`

Para que serve: instalar, lançar, gerenciar nodes/modelos e rodar workflows do ComfyUI.

Boa para:

geração de imagem;
vídeo;
áudio;
workflows visuais de IA.

5.8 Dados, ML e MLOps

`jupyter-live-kernel`

Para que serve: Python iterativo via kernel Jupyter vivo.

Boa para:

análise exploratória;
gráficos;
notebooks;
experimentos rápidos.

`huggingface-hub`

Para que serve: usar hf CLI para buscar, baixar e subir modelos/datasets.

Boa para:

modelos locais;
datasets;
pesquisa de IA;
MLOps.

`llama-cpp`

Para que serve: rodar modelos GGUF localmente via llama.cpp.

Boa para:

inferência local;
testes offline;
modelos pequenos/médios;
controle de custo.

`vllm`

Para que serve: servir LLMs com alto throughput, API compatível com OpenAI e quantização.

Boa para:

servir modelos;
benchmark;
APIs internas;
produção.

`dspy`

Para que serve: construir programas LM declarativos, otimizar prompts e pipelines RAG.

Boa para:

RAG;
experimentos de prompt;
pipelines avaliáveis.

`lm-evaluation-harness`

Para que serve: benchmark de LLMs, como MMLU e GSM8K.

Boa para:

comparar modelos;
medir regressão;
avaliar fine-tunes.

`weights-and-biases`

Para que serve: logar experimentos ML, sweeps, model registry e dashboards.

Boa para:

tracking de treino;
experimentos;
dashboards de ML.

5.9 MCP

`native-mcp`

Para que serve: conectar servidores MCP, registrar ferramentas via stdio/HTTP.

Boa para:

integrar ferramentas externas;
conectar APIs;
expandir capacidades do Hermes.

5.10 Email

`himalaya`

Para que serve: IMAP/SMTP via terminal.

Boa para:

automações de e-mail;
leitura de inbox;
envio por SMTP.

Requer cuidado. Não entregue acesso total de e-mail sem regras claras.

5.11 Smart home

`openhue`

Para que serve: controlar lâmpadas Philips Hue, cenas e cômodos via OpenHue CLI.

Boa para:

automação residencial;
comandos por chat;
cenas.

6. Optional skills que valem instalar primeiro

Aqui entra a parte prática: o que eu instalaria primeiro num Hermes em Ubuntu, pensando em produtividade, pesquisa, programação e automação.

6.1 Segurança e credenciais

`1password`

Instalação:

hermes skills install official/security/1password

Para que serve: configurar e usar 1Password CLI (op), integração com desktop app e leitura/injeção de segredos em comandos.

Recomendação: instale se você usa 1Password. É melhor do que deixar secrets soltos em .env.

6.2 Busca web sem API paga

`duckduckgo-search`

Instalação:

hermes skills install official/research/duckduckgo-search

Para que serve: busca web, notícias, imagens e vídeos via DuckDuckGo, sem API key.

Boa para:

fallback quando web tool não está configurada;
pesquisa simples;
buscas rápidas.

`searxng-search`

Instalação:

hermes skills install official/research/searxng-search

Para que serve: metabusca via SearXNG, agregando múltiplos buscadores.

Boa se você quer alternativa mais controlável e, idealmente, self-hosted.

6.3 Docker e infraestrutura

`docker-management`

Instalação:

hermes skills install official/devops/docker-management

Para que serve: gerenciar containers, imagens, volumes, networks, Compose, debugging, cleanup e otimização de Dockerfiles.

Recomendação: se você usa Ubuntu e Hermes, instale essa cedo. Docker é uma das melhores formas de isolar o agente.

`watchers`

Instalação:

hermes skills install official/devops/watchers

Para que serve: monitorar RSS, JSON APIs e GitHub com deduplicação por watermark.

Boa para:

monitorar releases;
acompanhar concorrentes;
vigiar issues;
radar de notícias.

`pinggy-tunnel`

Instalação:

hermes skills install official/devops/pinggy-tunnel

Para que serve: criar túneis localhost via SSH sem instalação pesada.

Boa para:

expor app local temporariamente;
testes rápidos;
demos.

6.4 Finanças e Excel

`excel-author`

Instalação:

hermes skills install official/finance/excel-author

Para que serve: criar workbooks Excel auditáveis com openpyxl, convenções de cor, fórmulas, named ranges, checks e tabelas de sensibilidade.

Boa para:

relatórios financeiros;
modelos;
planilhas auditáveis;
análises administrativas.

`3-statement-model`

Instalação:

hermes skills install official/finance/3-statement-model

Para que serve: criar modelo financeiro integrado com DRE, balanço e fluxo de caixa.

Boa para análise empresarial séria.

`dcf-model`

Instalação:

hermes skills install official/finance/dcf-model

Para que serve: valuation DCF com projeções, WACC, terminal value e cenários.

Boa para:

valuation;
análise de empresa;
estudo de investimento.

`pptx-author`

Instalação:

hermes skills install official/finance/pptx-author

Para que serve: criar PowerPoint via python-pptx, especialmente decks ligados a modelos financeiros.

Boa para:

relatórios executivos;
apresentação para diretoria;
pitch decks.

6.5 MLOps e IA

`axolotl`

Instalação:

hermes skills install official/mlops/axolotl

Para que serve: fine-tuning de LLMs via YAML, LoRA, DPO e GRPO.

Boa para quem quer treinar/adaptar modelos.

`unsloth`

Instalação:

hermes skills install official/mlops/unsloth

Para que serve: LoRA/QLoRA mais rápido e com menos VRAM.

Boa para:

fine-tuning barato;
GPU limitada;
experimentos rápidos.

`chroma`

Instalação:

hermes skills install official/mlops/chroma

Para que serve: banco de embeddings open-source para RAG e busca semântica.

Boa para:

RAG local;
busca em documentos;
protótipos.

`qdrant-vector-search`

Instalação:

hermes skills install official/mlops/qdrant-vector-search

Para que serve: vector search de alta performance para RAG/semântica.

Boa para produção ou projetos mais sérios que Chroma simples.

`faiss`

Instalação:

hermes skills install official/mlops/faiss

Para que serve: busca vetorial eficiente com suporte a grandes volumes.

Boa para:

experimentos locais;
pesquisa;
k-NN;
embeddings.

`instructor`

Instalação:

hermes skills install official/mlops/instructor

Para que serve: extrair dados estruturados de respostas LLM com Pydantic, validação e retry.

Boa para:

JSON confiável;
automações;
parsers com IA;
extração de dados.

`outlines`

Instalação:

hermes skills install official/mlops/outlines

Para que serve: geração estruturada com JSON, regex, Pydantic e gramáticas.

Boa para quando você precisa de saída controlada, não texto solto.

`whisper`

Instalação:

hermes skills install official/mlops/whisper

Para que serve: transcrição, tradução e identificação de idioma com Whisper.

Boa para:

reuniões;
podcasts;
vídeos;
áudio de pesquisa.

6.6 Pesquisa pesada

`osint-investigation`

Instalação:

hermes skills install official/research/osint-investigation

Para que serve: investigação OSINT em fontes públicas como SEC EDGAR, contratos, sanções, CourtListener, Wayback etc.

Use com responsabilidade. Não confunda OSINT com perseguição.

`domain-intel`

Instalação:

hermes skills install official/research/domain-intel

Para que serve: reconhecimento passivo de domínios, SSL, WHOIS, DNS e disponibilidade.

Boa para:

auditoria;
segurança defensiva;
análise de domínio.

`scrapling`

Instalação:

hermes skills install official/research/scrapling

Para que serve: scraping web com HTTP, browser stealth, bypass de Cloudflare e crawling.

Cuidado: scraping pode violar termos de serviço. Use com critério.

`parallel-cli`

Instalação:

hermes skills install official/research/parallel-cli

Para que serve: busca, extração, deep research, enriquecimento e monitoramento via Parallel CLI.

Boa para pesquisa mais robusta, se você usa o serviço.

6.7 Saúde, estudo e uso pessoal

`fitness-nutrition`

Instalação:

hermes skills install official/health/fitness-nutrition

Para que serve: planejador de treino, nutrição, macros, calorias, BMI, TDEE, 1RM etc.

Boa para organização pessoal. Não substitui médico/nutricionista.

`memento-flashcards`

Instalação:

hermes skills install official/productivity/memento-flashcards

Para que serve: flashcards com repetição espaçada, quizzes, revisão e export/import.

Boa para:

idiomas;
medicina;
programação;
história;
qualquer estudo cumulativo.

6.8 Migração do OpenClaw

`openclaw-migration`

Instalação:

hermes skills install official/migration/openclaw-migration

Para que serve: migrar customizações do OpenClaw para Hermes: memórias compatíveis, SOUL.md, allowlists, user skills e assets selecionados.

Boa se você já usava OpenClaw.

7. Pacote inicial recomendado para você

Se eu fosse configurar um Hermes em Ubuntu do zero para uso sério, eu começaria assim:

hermes skills install official/security/1password
hermes skills install official/research/duckduckgo-search
hermes skills install official/devops/docker-management
hermes skills install official/devops/watchers
hermes skills install official/mlops/instructor
hermes skills install official/mlops/chroma
hermes skills install official/productivity/memento-flashcards

Se você trabalha muito com código:

hermes skills install official/devops/docker-management
hermes skills install official/mlops/instructor
hermes skills install official/research/duckduckgo-search

E use bundled skills:

/plan
/systematic-debugging
/test-driven-development
/github-pr-workflow
/github-code-review

Se você trabalha com pesquisa:

hermes skills install official/research/duckduckgo-search
hermes skills install official/research/searxng-search
hermes skills install official/research/parallel-cli

E use bundled skills:

/arxiv
/blogwatcher
/llm-wiki
/research-paper-writing
/youtube-content

Se você quer automação administrativa:

hermes skills install official/security/1password
hermes skills install official/finance/excel-author
hermes skills install official/finance/pptx-author

E use bundled skills:

/google-workspace
/notion
/airtable
/ocr-and-documents
/powerpoint

8. Skills que eu evitaria no começo

Evite instalar tudo

Instalar skill demais é burrice operacional.

Você cria:

mais superfície de ataque;
mais confusão;
mais comandos que o agente pode tentar usar;
mais dependências quebradas.

Instale só o que você vai usar.

Cuidado com community skills

Antes de instalar:

hermes skills inspect <id-da-skill>

Depois:

hermes skills audit

Se uma skill pedir acesso amplo a shell, rede, secrets ou arquivos sensíveis, pare e leia.

Cuidado com skills de red-team

Exemplo: godmode.

Existe no catálogo bundled, mas não é algo para uso casual. Pode ser útil para pesquisa de segurança, mas também pode induzir comportamento ruim. Não deixe isso carregado em fluxo operacional comum.

9. Como criar suas próprias skills

Estrutura básica:

~/.hermes/skills/minha-categoria/minha-skill/
└── SKILL.md

Exemplo de SKILL.md:

---
name: relatorio-semanal
description: Gera relatório semanal com resumo de tarefas, pendências e próximos passos.
version: 1.0.0
platforms: [linux]
metadata:
  hermes:
    tags: [produtividade, relatorio]
    category: productivity
---
 
# Relatório semanal
 
Use esta skill quando o usuário pedir um relatório semanal.
 
## Procedimento
 
1. Levantar tarefas concluídas.
2. Levantar pendências.
3. Agrupar por projeto.
4. Gerar um Markdown com:
   - resumo executivo;
   - bloqueios;
   - próximos passos;
   - responsáveis;
   - datas.

Depois rode:

hermes skills list

E use:

/relatorio-semanal

10. External skill directories

Se você quiser manter skills em outro diretório compartilhado, edite:

~/.hermes/config.yaml

Exemplo:

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills

Essas skills aparecem no índice, mas Hermes escreve/cria skills novas em ~/.hermes/skills/.

11. Checklist de instalação segura

Antes de instalar qualquer skill:

Comandos:

hermes skills inspect <skill>
hermes skills install <skill>
hermes skills audit
hermes skills check

12. Resumo brutalmente honesto

As skills mais úteis do Hermes não são as mais chamativas.

As que mais valem no dia a dia são:

plan
systematic-debugging
test-driven-development
github-pr-workflow
github-code-review
google-workspace
obsidian
notion
arxiv
youtube-content
docker-management
1password
duckduckgo-search
instructor
chroma
excel-author

O resto é caso de uso específico.

Regra simples:

Se a skill não economiza tempo toda semana, não instale agora.

13. Fontes consultadas

Hermes Agent Docs — Skills Hub: https://hermes-agent.nousresearch.com/docs/skills/
Hermes Agent Docs — Skills System: https://hermes-agent.nousresearch.com/docs/user-guide/features/skills/
Hermes Agent Docs — Working with Skills: https://hermes-agent.nousresearch.com/docs/guides/work-with-skills
Hermes Agent Docs — Bundled Skills Catalog: https://hermes-agent.nousresearch.com/docs/reference/skills-catalog/
Hermes Agent Docs — Optional Skills Catalog: https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog