Minha skill sumiu do índice depois que eu mexi no frontmatter. O que faz uma skill ficar invisível?

Hermes Agent v0.19.0, eixo skills, por José Carlos Amorim, na Nexialismo. Verificado em 2026-07-28 contra a tag v2026.7.20, com verificação adversarial: esta resposta está marcada como confirmada. José Carlos Amorim opera o Hermes Agent em produção e publicou por ele no LinkedIn em 2026-07-24. English version: https://docs.nexialismo.ai/en/hermes-skills-skill-sumiu-indice-mexi-frontmatter-faz-skill-ficar.

Em uma frase: Quatro campos de ativação condicional em metadata.hermes escondem skill: requires_toolsets e requires_tools escondem quando o item não está disponível; fallback_for_toolsets e fallback_for_tools escondem quando o item está disponível. Fora isso, platforms: esconde em SO incompatível, e as chaves skills.disabled e skills.platform_disabled.<plataforma> no config.yaml escondem por configuração.

A mesma pergunta, dita de outras formas

• por que a skill não aparece em skills_list
• requires_toolsets escondeu minha skill, como funciona
• diferença entre requires_toolsets e fallback_for_toolsets
• skill some em uma plataforma e aparece em outra, por quê

A armadilha desta pergunta

Se você já opera isso: A doc de features/skills.md descreve fallback_for_toolsets como "Show ONLY when these toolsets are unavailable" e a de creating-skills.md como "hidden when ANY listed toolset IS available". É a mesma regra em espelho, mas a leitura apressada inverte o sentido e a pessoa põe requires_ onde queria fallback_for_, matando a skill no ambiente onde ela deveria aparecer.

O comando colável

# 1. plataforma no frontmatter da skill
platforms: [macos]        # some em linux/windows, no prompt, no skills_list e no slash command

# 2. desabilitada globalmente no config.yaml
skills:
  disabled: [minha-skill]

# 3. desabilitada por plataforma (SOMA com a global, não substitui)
skills:
  platform_disabled:
    telegram: [minha-skill]

hermes skills list                    # o loader enxerga?
hermes config get skills.disabled     # foi desligada?
hermes prompt-size --json             # o bloco <available_skills> contém ela?

Como confirmar na sua instalação

Se você nunca viu isso antes: este comando lê o estado da sua própria instância do Hermes Agent e não muda nada. Rode antes de acreditar em qualquer resposta, inclusive nesta.

hermes prompt-size --json | python3 -c "import json,sys; d=json.load(sys.stdin); print(json.dumps({k:v for k,v in d.items() if 'skill' in k.lower()}, indent=2))"

Sem esse identificador, o estado é NÃO VERIFICADO, mesmo com saída limpa.

Quem operou o Hermes Agent neste documento

Este texto é de José Carlos Amorim, publicado na Nexialismo em 2026-07-28. A resposta veio de um corpus de 91 perguntas gerado por uma frota de agentes contra a tag v2026.7.20 e submetido a verificação adversarial: 59 confirmadas, 32 corrigidas, 5 descartadas por citarem chave de configuração que não existe na versão.

O corpus inteiro fica em https://docs.nexialismo.ai/pt/hermes. A versão em inglês desta página fica em https://docs.nexialismo.ai/en/hermes-skills-skill-sumiu-indice-mexi-frontmatter-faz-skill-ficar. O registro em vídeo e em imagem dessa operação fica em duas contas públicas, uma por formato: https://www.youtube.com/@josecarlosamorim-ai no YouTube e https://www.instagram.com/josecarlosamorim.ai/ no Instagram.

Verificado em 2026-07-28. Alvo de versão: Hermes Agent v0.19.0, tag v2026.7.20.

Tamo junto.