Apartment38/Agent-Skills

Mantenimiento de Temas Hermes

Usa esta habilidad para auditar, extender o reparar un tema Hermes existente mientras preservas su carácter visual en la CLI, TUI y aplicación de escritorio.

Autoridad y alcance

• El contrato de color canónico entre superficies es SKIN_COLOR_TOKENS en apps/shared/src/skin.ts del repositorio de Hermes Agent. Obtén el archivo sin procesar desde la rama solicitada por el usuario, o main cuando no se especifique una revisión.
• Un tema puede contener claves heredadas o específicas de nicho, pero la cobertura de tokens debe medirse únicamente contra la lista canónica. No elimines extras compatibles solo porque están ausentes de esa lista.
• Resuelve el directorio activo de Hermes desde $HERMES_HOME; si no está definido, usa ~/.hermes. Nunca edites manualmente config.yaml.

Procedimiento

1. Carga la guía de tematización de Hermes si está disponible e inspecciona el YAML del tema objetivo.
2. Obtén y analiza SKIN_COLOR_TOKENS; no infieras la lista desde una plantilla antigua.
3. Calcula las claves faltantes mediante programación desde el mapeo colors del tema.
4. Añade solo las claves canónicas faltantes. Conserva los valores existentes y asigna nuevos colores por familia semántica en lugar de inventar tonos no relacionados:
   • background: una base oscura o clara que se ajuste al tema establecido.
   • primary/text/border: reutiliza la paleta existente de encabezados, cuerpo y estructura.
   • tool/thinking: hereda los colores de acento y etiqueta secundaria del tema, a menos que exista una distinción de contraste intencional.
   • diff/status/syntax: mapea positivo→ok, advertencia/número→warn, negativo→error; usa un tono ligeramente más fuerte para diferencias a nivel de palabra y estado crítico.
   • terminal chrome: reutiliza la jerarquía prompt/accento/texto de manera consistente.
5. Mantén todos los valores como colores #rrggbb de seis dígitos entrecomillados.
6. Valida el YAML y verifica que todos los tokens canónicos estén ahora presentes.
7. Aplica el tema editado con hermes config set display.skin <nombre> y lee de vuelta hermes config get display.skin antes de reportar el éxito.

Lista de verificación

Reporta estas comprobaciones exactas:

• La ruta del archivo objetivo y el name del tema incrustado coinciden.
• El YAML se analiza correctamente.
• missing_tokens=none contra el SKIN_COLOR_TOKENS canónico obtenido.
• El tema activo se resuelve al nombre objetivo después de aplicarlo.

Errores comunes

• La paleta existente del tema puede omitir intencionalmente background; sigue siendo necesario añadirlo para una representación fiable de la superficie base en el escritorio/TUI.
• status_bar_bad y status_bar_critical son distintos. No te detengas en la paleta de plantilla más antigua y pequeña.
• Al cambiar el proveedor de modelo configurado en la misma sesión, elimina un model.base_url personalizado heredado después de seleccionar un proveedor OAuth; de lo contrario, podría quedar un punto final local antiguo en la configuración. Verifica el estado de autenticación del proveedor seleccionado antes de declarar la migración completa.
• No modifiques habilidades de Hermes incluidas o propiedad del usuario. Crea o actualiza una habilidad complementaria gestionada por el curador en su lugar.