..

Guia de Skills do Hermes Agent

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”:

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

  1. vê uma lista compacta das skills disponíveis;
  2. abre a skill completa só quando precisa;
  3. 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:

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
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:

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:


spike

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

Boa para:


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:


test-driven-development

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

Boa para:


requesting-code-review

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

Boa para:


python-debugpy

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

Boa para:


node-inspect-debugger

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

Boa para:


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:

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:


github-issues

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

Boa para:


github-repo-management

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

Boa para:


5.4 Pesquisa e conhecimento

arxiv

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

Boa para:

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:


research-paper-writing

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

Boa para:


blogwatcher

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

Boa para:


5.5 Produtividade

google-workspace

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

Boa para:

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:


obsidian

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

Boa para:


linear

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

Boa para:


airtable

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

Boa para:


maps

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

Boa para:


nano-pdf

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

Boa para:

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:


powerpoint

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

Boa para:


5.6 Mídia e conteúdo

youtube-content

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

Boa para:


spotify

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

Boa para:


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

Boa para:


songwriting-and-ai-music

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

Boa para:


songsee

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

Boa para:


5.7 Criatividade e visual

architecture-diagram

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

Boa para:


excalidraw

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

Boa para:


claude-design

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

Boa para:


sketch

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

Boa para:


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

Boa para:


comfyui

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

Boa para:


5.8 Dados, ML e MLOps

jupyter-live-kernel

Para que serve: Python iterativo via kernel Jupyter vivo.

Boa para:


huggingface-hub

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

Boa para:


llama-cpp

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

Boa para:


vllm

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

Boa para:


dspy

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

Boa para:


lm-evaluation-harness

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

Boa para:


weights-and-biases

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

Boa para:


5.9 MCP

native-mcp

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

Boa para:


5.10 Email

himalaya

Para que serve: IMAP/SMTP via terminal.

Boa para:

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:


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

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:


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:


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:


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:


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:


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:


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:


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:


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:


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:


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:


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:


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:


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:

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:

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