# Qual é a ordem canônica das seções do corpo de uma SKILL.md? Vi duas versões diferentes.

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-md-ordem-canonica-secoes-corpo-duas-versoes.

**Em uma frase:** As duas fontes divergem e o repositório decide. A página pública mostra 5 seções (When to Use, Quick Reference, Procedure, Pitfalls, Verification). O padrão HARDLINE do repo, que é o que o reviewer cobra e o que o `/learn` embute no prompt, tem 8: título + intro de 2 a 3 frases, When to Use, Prerequisites, How to Run, Quick Reference, Procedure, Pitfalls, Verification. Alvo ~100 linhas para skill simples, ~200 para complexa.

## A mesma pergunta, dita de outras formas

- quantas seções tem uma SKILL.md do Hermes
- a doc mostra 5 seções e o AGENTS.md mostra 8, qual vale
- preciso de Prerequisites e How to Run na minha skill
- qual o tamanho alvo de uma SKILL.md

## A armadilha desta pergunta

**Se você já opera isso:** Copiar o template de 5 seções da página pública e omitir `## Prerequisites` numa skill que precisa de env var. A env var acaba enterrada dentro do Procedure, o agente não vê antes de começar, e a skill falha no meio da execução em vez de falhar no gate de 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.

```bash
grep -h '^## ' ~/.hermes/skills/*/*/SKILL.md | sort | uniq -c | sort -rn | head -15
```

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-md-ordem-canonica-secoes-corpo-duas-versoes. 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.