Hermes Skills Hub: inspecionar, instalar, ativar e validar um Skill

Um Skill do Hermes é um procedimento carregado sob demanda, não um plug-in que precisa ocupar o contexto o tempo todo. Os problemas normalmente aparecem depois da busca: instalar sem revisar, ignorar o relatório de segurança, continuar em uma sessão antiga ou esperar que uma frase livre acione o Skill sem produzir um resultado verificável.

Este fluxo usa o Skill opcional oficial ascii-art. Ele é adequado para a primeira validação porque o resultado é visível, pode ser salvo como texto e medido com um script curto. Os comandos e comportamentos foram conferidos em páginas oficiais abertas em 10 de outubro de 2026. A saída pode variar por versão; use o identifier e o relatório retornados pelo seu Hermes.

Visão geral do fluxo

Etapa	Ação	Critério de aprovação
Buscar	Pesquisar no Hub e copiar o identifier completo	Fonte e alvo exato conhecidos, sem adivinhar caminho
Inspecionar	Usar inspect para metadados e preview truncado de SKILL.md, depois abrir os arquivos completos da fonte e versão exatas	As seis verificações ficam claras; caso contrário, a instalação para
Instalar	Usar a CLI interativa quando alguém precisa decidir antes da cópia; no chat, o próprio comando vale como consentimento	O limite de confirmação pós-scan de cada rota está claro
Ativar	Abrir nova sessão; usar --now no chat só depois de revisar o bundle exato	A sessão reconhece o comando do Skill
Verificar	Confirmar source e path efetivos; executar audit só em instalação Hub registrada e não sombreada	A cópia realmente carregada foi revisada
Validar	Salvar a saída e medir limites	O arquivo existe e cumpre o contrato

1. Preparar, buscar e inspecionar

Você precisa de uma instalação funcional do Hermes e de um terminal que execute hermes skills .... Para a primeira tentativa, escolha um Skill oficial sem conta, segredo ou permissão de escrita em sistema externo.

hermes skills list
hermes skills search "ascii art"

Se ascii-art já estiver na lista, não presuma que seja uma instalação do Hub nem sobrescreva só para acompanhar o exemplo. Confirme a fonte e o path efetivo; uma cópia homônima em .hermes/skills/ ou .agents/skills/ do projeto tem precedência sobre a cópia global. O audit posterior só cobre o conteúdo usado por /ascii-art quando a cópia está registrada no Hub e não está sombreada. Caso contrário, leia os arquivos completos da cópia ativa ou escolha outro Skill opcional oficial para concluir o fluxo Hub install/audit. Copie o identifier da busca; official/creative/ascii-art é o path atual, mas a fonte e versão reais são decisivas.

hermes skills inspect official/creative/ascii-art

inspect é somente leitura, mas não é uma revisão completa: a implementação oficial mostra apenas as primeiras 50 linhas de SKILL.md. Antes de instalar, abra o SKILL.md inteiro e os arquivos de apoio referenciados na fonte e versão reais. A versão completa do ASCII Art fixada neste guia tem 322 linhas; chamadas de rede, instalação com sudo e custom fallback aparecem depois do preview. Confirme fonte, plataformas, dependências, rede, arquivos/comandos e configuração/credenciais; se qualquer um desses seis pontos não ficar claro, pare. O teste abaixo proíbe instalação e rede e exige o fallback direto.

2. Instalar sem ignorar o scan de segurança

hermes skills install official/creative/ascii-art

A implementação oficial baixa primeiro para quarantine e executa o scanner. Se a política de scan permitir, a CLI interativa normal pede confirmação antes de copiar para o diretório local. Use essa rota quando precisar ler findings e tomar uma decisão humana antes da cópia.

Não olhe apenas a indicação de sucesso: leia o verdict, cada finding, arquivo e tipo de risco. Pare diante de risco alto ou sem explicação; force não deve ser a resposta padrão. O scan é uma barreira de instalação, não uma garantia sobre dependências externas, serviços ou qualidade da saída.

Para instalar pelo chat e aplicar imediatamente:

/skills install official/creative/ascii-art --now

A action de chat /skills install chama o instalador com skip_confirm=True: digitar o comando é consentimento implícito. Se o scan permitir o bundle, não existe uma pausa humana separada para ler findings e cancelar antes da cópia. Para a primeira revisão, use a CLI interativa e depois uma sessão nova.

--now apenas invalida e reconstrói o cache de Skills da sessão atual; não adiciona confirmação. Use só depois de revisar e aceitar a fonte e versão exatas, e não acrescente ao hermes skills install no terminal.

3. Ativar e verificar na sessão correta

Uma instalação normal via CLI deve ser testada em nova sessão. Uma conversa aberta antes da instalação pode manter o índice inicial mesmo com arquivos em ~/.hermes/skills/. Abra outra sessão ou use /reset; use --now na sessão atual somente após a revisão completa e aceitando o consentimento implícito do comando de chat.

Depois, verifique no terminal:

hermes skills list
# Somente se ascii-art estiver registrado no lock file do Hub:
hermes skills audit ascii-art

A lista confirma discovery e ajuda a identificar a fonte efetiva. audit percorre apenas instalações registradas em HubLockFile: sem elas mostra No hub-installed skills to audit; para nome não Hub, is not a hub-installed skill. Isso não significa corrupção nem prova que a cópia visível foi escaneada. Se uma cópia homônima do projeto sombrear a do Hub, audit continua no path do lock file enquanto /ascii-art carrega a cópia do projeto; leia os arquivos completos do path ativo ou use outro Skill oficial sem shadowing. Em uma instalação Hub aplicável, corrija arquivos ausentes, path inválido ou findings de risco antes da tarefa.

/ascii-art

Se o Hermes reconhecer o comando e esperar instruções, o registro da sessão está ativo. A chamada explícita remove a incerteza do roteamento por linguagem natural.

4. Executar uma tarefa real, salvar e validar

Envie na mesma sessão:

/ascii-art Use o fallback de geração personalizada para criar um banner que escreva HERMES apenas com caracteres ASCII. Não instale pacotes nem use serviços de rede. Retorne exatamente um bloco de texto cercado, com no máximo 60 caracteres de largura e 15 linhas de altura.

A tarefa é síncrona: não há job ID nem polling. Aguarde a resposta do mesmo turno e salve somente o conteúdo do bloco em hermes-ascii.txt.

Salve este validador como validate_ascii.py:

from pathlib import Path

path = Path("hermes-ascii.txt")
text = path.read_text(encoding="utf-8")
lines = text.splitlines()
width = max((len(line) for line in lines), default=0)
ascii_only = text.isascii()
print({"lines": len(lines), "max_width": width, "ascii_only": ascii_only})
raise SystemExit(not (lines and len(lines) <= 15 and width <= 60 and ascii_only))

Depois execute:

python validate_ascii.py

A tarefa passa quando /ascii-art é reconhecido, HERMES está legível, o arquivo não está vazio, o script mostra ascii_only: True e termina com código 0, e não houve pedido de pacote, rede ou credencial. O desenho pode variar; o contrato mensurável permanece.

A checagem ASCII é obrigatória: o custom fallback oficial inclui caracteres Unicode de linha e bloco, então medir apenas altura, largura e legibilidade aceitaria incorretamente algo como HERMES ░. Se ascii_only for False, repita o mesmo prompt pedindo para substituir todo caractere não ASCII, sobrescreva o arquivo e rode o validador novamente.

5. Diagnóstico por sintoma

Sintoma	Primeira checagem	Correção e reteste
A busca não encontra o alvo	Consulta ou filtro estreito	Amplie termos, copie o identifier atual e rode inspect
inspect funciona, download falha	Arquivos movidos, rede ou rate limit	Pesquise de novo; não continue adivinhando caminho antigo
O scan bloqueia a instalação	Verdict, arquivo e tipo de risco	Pare, revise o conteúdo ou escolha outro Skill
A lista mostra, mas /ascii-art não	A sessão começou antes da instalação	Abra nova sessão ou /reset; use --now na instalação pelo chat quando necessário
O comando funciona, a frase livre não	O roteador não selecionou o Skill	Use primeiro /ascii-art <tarefa> e teste linguagem natural separadamente
Conteúdo inesperado com o mesmo nome	O path efetivo pode ser uma cópia de projeto enquanto audit verificou o Hub lock path	Confira .hermes/skills/ e .agents/skills/, leia os arquivos completos da cópia ativa e não trate o audit da cópia Hub sombreada como prova do conteúdo de /ascii-art
A tarefa pede pacote ou rede	Foi escolhida uma rota pyfiglet, cowsay ou web	Repita o prompt exigindo custom fallback sem instalação nem rede
Audit de instalação Hub mudou	Arquivos no Hub lock path foram alterados ou atualizados	Pare de usar, identifique a mudança, repita audit e a mesma tarefa mínima
O Skill não aparece em outra plataforma (CLI/Telegram/Discord)	Ele pode estar desativado nessa plataforma ou ter uma restrição incompatível em platforms	Confira a ativação ou desativação específica de CLI, Telegram ou Discord e o platforms do Skill; corrija, abra nova sessão nessa plataforma e repita a mesma tarefa mínima

Altere uma variável por vez e repita a tarefa HERMES. Assim você separa falhas de descoberta, instalação, carregamento da sessão, routing e execução.

6. Escolher pelo trabalho, não por ranking genérico

Pergunte se o Skill resolve a tarefa atual, se inspect esclarece permissões e dependências, se a origem é rastreável, se há um sinal de sucesso repetível e se o fluxo pode parar antes de escrever em um sistema externo. Para começar, prefira entradas pequenas, permissões mínimas e uma saída salvável.

Checklist final

• A busca retornou um identifier completo.
• inspect foi tratado como preview truncado, e SKILL.md mais arquivos de apoio completos foram lidos na fonte e versão exatas.
• Quando era preciso decidir antes da cópia, a CLI interativa foi usada e verdict/findings foram lidos.
• Uma nova sessão foi usada; --now no chat só após revisão completa e aceitando que não há confirmação pós-scan.
• A fonte ativa foi confirmada com hermes skills list; audit só rodou em instalação Hub registrada e não sombreada.
• /ascii-art foi chamado, hermes-ascii.txt salvo e passou em tamanho, ASCII-only e legibilidade.
• Cada falha foi atribuída a uma camada e retestada com a mesma tarefa.

Isso prova mais do que a existência de uma pasta: o Skill foi encontrado, entendido, aceito pelo controle de instalação, carregado em uma sessão, executado e validado por um resultado salvo.

Fontes oficiais

• Working with Skills
• Optional Skills
• ASCII Art Skill
• Skills System