Apartment38/Agent-Skills

Manutenção de Skin do Hermes

Use esta habilidade para auditar, estender ou reparar uma skin existente do Hermes, preservando seu caráter visual nas interfaces CLI, TUI e desktop.

Autoridade e escopo

• O contrato canônico de cores entre superfícies é SKIN_COLOR_TOKENS em apps/shared/src/skin.ts no repositório do Agente Hermes. Busque o arquivo bruto da branch solicitada pelo usuário, ou main quando nenhuma revisão for especificada.
• Uma skin pode conter chaves legadas ou de nicho, mas a cobertura de tokens deve ser medida apenas contra a lista canônica. Não exclua extras compatíveis apenas por estarem ausentes dessa lista.
• Resolva o diretório ativo do Hermes a partir de $HERMES_HOME; se não estiver definido, use ~/.hermes. Nunca edite manualmente config.yaml.

Procedimento

1. Carregue as orientações de tema do Hermes, se disponíveis, e inspecione o YAML da skin alvo.
2. Busque e analise SKIN_COLOR_TOKENS; não infira a lista a partir de um template antigo.
3. Calcule programaticamente as chaves ausentes a partir do mapeamento colors da skin.
4. Adicione apenas as chaves canônicas ausentes. Preserve valores existentes e atribua novas cores por família semântica, em vez de inventar matizes não relacionados:
   • background: uma base escura ou clara que se encaixe na skin estabelecida.
   • primary/text/border: reutilize a paleta existente de cabeçalhos, corpo e estrutura.
   • tool/thinking: herde as cores de acento e rótulo secundário da skin, a menos que exista uma distinção intencional de contraste.
   • diff/status/syntax: mapeie positive→ok, warning/number→warn, negative→error; use um tom ligeiramente mais forte para diffs em nível de palavra e status crítico.
   • chrome do terminal: reutilize a hierarquia de prompt/accento/texto de forma consistente.
5. Mantenha todos os valores como cores citadas de seis dígitos #rrggbb.
6. Valide o YAML e verifique se todos os tokens canônicos estão agora presentes.
7. Aplique a skin editada com hermes config set display.skin <nome> e leia hermes config get display.skin antes de relatar sucesso.

Lista de verificação

Relate estas verificações exatas:

• O caminho do arquivo alvo e o name embutido da skin concordam.
• O YAML é analisado com sucesso.
• missing_tokens=none em relação ao SKIN_COLOR_TOKENS canônico buscado.
• A skin ativa resolve para o nome alvo após aplicá-la.

Armadilhas

• A paleta existente da skin pode omitir intencionalmente background; adicioná-lo ainda é necessário para renderização confiável da superfície base no desktop/TUI.
• status_bar_bad e status_bar_critical são distintos. Não pare na paleta de template mais antiga e menor.
• Ao alterar o provedor de modelo configurado na mesma sessão, remova um model.base_url personalizado herdado após selecionar um provedor OAuth; caso contrário, um endpoint local antigo pode permanecer na configuração. Verifique o status de autenticação do provedor selecionado antes de declarar a migração concluída.
• Não modifique skills do Hermes empacotadas ou de propriedade do usuário. Crie ou atualize uma skill companheira gerenciada por curador.