Minha skill precisa de uma API key e de um caminho de pasta. Ponho os dois em `metadata.hermes.config`?

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-metadata-hermes-config-skill-precisa-api-key-caminho.

Em uma frase: Não. A regra de roteamento é: segredo vai em required_environment_variables (grava em ~/.hermes/.env, nunca é mostrado ao modelo); valor não sensível como caminho ou preferência vai em metadata.hermes.config (grava em config.yaml sob skills.config e aparece em hermes config show). Credencial que é arquivo (OAuth token JSON) tem um terceiro campo: required_credential_files.

A mesma pergunta, dita de outras formas

onde declaro segredo numa SKILL.md do Hermes
qual a diferença entre required_environment_variables e metadata.hermes.config
como faço a skill pedir a chave sem expor pro modelo
posso guardar token em config.yaml na skill

A armadilha desta pergunta

Se você já opera isso: Material N3/N4 costuma mostrar só o bloco config: porque é o exemplo mais curto, e o leitor conclui que serve para tudo. required_credential_files é o campo menos conhecido dos três e não está na maioria dos resumos de terceiros.

O comando colável

---
name: minha-skill
description: Faz X no serviço Y.
metadata:
  hermes:
    config:                      # NÃO SEGREDO -> config.yaml
      - key: minha.pasta
        description: Pasta de dados da skill
        default: "~/dados"
        prompt: Caminho da pasta de dados
required_environment_variables: # SEGREDO string -> ~/.hermes/.env
  - name: MINHA_API_KEY
    prompt: "Chave da API Y"
    help: "Pegue em https://y.com/keys"
    required_for: "acesso à API"
required_credential_files:      # SEGREDO arquivo -> ~/.hermes/<path>
  - path: google_token.json
    description: Google OAuth2 token (created by setup script)
---

hermes config set skills.config.minha.pasta ~/dados
hermes config get skills.config.minha.pasta
# segredo: edite ~/.hermes/.env ou use `hermes setup`

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 config show | grep -A 20 'Skill Settings'

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-metadata-hermes-config-skill-precisa-api-key-caminho. 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.