Hermes Skills Hub: inspeccionar, instalar, activar y validar un Skill

Un Skill de Hermes es un procedimiento que se carga cuando hace falta, no un complemento que deba ocupar siempre el contexto. Los errores suelen aparecer después de encontrarlo: se instala sin revisar, se ignora el informe de seguridad, se sigue usando una sesión antigua o se espera que una frase libre active automáticamente el Skill sin dejar un resultado comprobable.

Este recorrido usa el Skill opcional oficial ascii-art. Es adecuado para una primera validación porque genera un resultado visible, se puede guardar como texto y permite comprobar límites con un script. Los comandos y comportamientos se contrastaron con páginas oficiales abiertas el 10 de octubre de 2026. La salida puede variar según la versión; usa siempre el identifier y el informe que devuelva tu instalación.

Ruta completa

Etapa	Acción	Señal de éxito
Buscar	Consultar el Hub y copiar el identifier completo	Conoces la fuente y no adivinas la ruta
Inspeccionar	Usar inspect para metadatos y una vista previa truncada de SKILL.md; abrir después los archivos completos de la fuente y versión exactas	Las seis comprobaciones quedan resueltas; si no, se detiene la instalación
Instalar	Usar la CLI interactiva si una persona debe decidir antes de copiar; en el chat, escribir el comando equivale a consentir	Entiendes el punto de confirmación posterior al scan de cada ruta
Activar	Abrir una sesión nueva; usar --now en el chat solo tras revisar el bundle exacto	La sesión reconoce el comando del Skill
Verificar	Confirmar source y path efectivos; ejecutar audit solo sobre una instalación Hub registrada y no oculta	Se ha revisado la copia que realmente se carga
Validar	Guardar la salida y medirla	El archivo existe y cumple el contrato

1. Preparar, buscar e inspeccionar

Necesitas Hermes funcionando y una terminal que acepte hermes skills .... Para el primer intento elige un Skill oficial, sin cuentas, secretos ni permisos de escritura externos.

hermes skills list
hermes skills search "ascii art"

Si ascii-art ya aparece en la lista, no supongas que es una instalación del Hub ni lo sobrescribas solo para seguir el ejemplo. Confirma la fuente y el path efectivo; una copia homónima en .hermes/skills/ o .agents/skills/ del proyecto tiene prioridad sobre la copia global. El audit posterior solo cubre el contenido que ejecutará /ascii-art si la copia está registrada por el Hub y no está oculta. En otro caso, revisa los archivos completos de la copia activa o elige otro Skill opcional oficial para completar el flujo Hub install/audit. Copia el identifier de la búsqueda; official/creative/ascii-art es la ruta actual, pero mandan la fuente y versión reales.

hermes skills inspect official/creative/ascii-art

inspect es de solo lectura, pero no revisa el archivo completo: la implementación oficial muestra solo las primeras 50 líneas de SKILL.md. Antes de instalar, abre el SKILL.md completo y los archivos auxiliares referenciados desde la fuente y versión reales. La versión completa de ASCII Art fijada para esta guía tiene 322 líneas; las llamadas de red, la instalación con sudo y el custom fallback aparecen después de la vista previa. Comprueba fuente, plataformas, dependencias, red, archivos/comandos y configuración/credenciales; si alguno de estos seis puntos no queda claro, detente. La prueba posterior prohíbe instalaciones y red y exige el fallback directo.

2. Instalar leyendo el escaneo de seguridad

hermes skills install official/creative/ascii-art

La implementación oficial descarga primero en quarantine y ejecuta el scanner. Si la política de scan lo permite, la CLI interactiva normal pide confirmación antes de copiar al directorio local. Usa esta ruta cuando necesites leer findings y decidir personalmente antes de la copia.

No te limites a buscar una línea verde: lee el verdict, cada finding, su archivo y tipo de riesgo. Si queda un riesgo alto o inexplicable, detente; no uses force como respuesta normal. El scan es una barrera de instalación, no una garantía de todas las dependencias, servicios o salidas.

Para instalar desde el chat y aplicar el cambio inmediatamente:

/skills install official/creative/ascii-art --now

La acción de chat /skills install llama al instalador con skip_confirm=True: escribir el comando se considera consentimiento implícito. Si el scan permite el bundle, no hay una pausa humana separada para leer findings y cancelar antes de copiar. Para una primera revisión, usa la CLI interactiva y después una sesión nueva.

--now solo invalida y reconstruye la caché de Skills de la sesión actual; no añade una confirmación. Úsalo únicamente después de revisar y aceptar esa fuente y versión exactas, y no lo añadas a hermes skills install en terminal.

3. Activar y verificar en la sesión correcta

Una instalación normal por CLI debe probarse en una sesión nueva. Una conversación abierta antes de instalar puede conservar el índice inicial aunque los archivos estén en ~/.hermes/skills/. Abre otra sesión o usa /reset; usa --now en la sesión actual solo tras la revisión completa y aceptando el consentimiento implícito del comando de chat.

Después verifica en terminal:

hermes skills list
# Solo si ascii-art figura en el lock file del Hub:
hermes skills audit ascii-art

La lista confirma descubrimiento y ayuda a identificar la fuente efectiva. audit solo recorre instalaciones registradas en HubLockFile: sin ellas muestra No hub-installed skills to audit, y para un nombre no Hub, is not a hub-installed skill. Eso no implica corrupción ni demuestra que la copia visible esté escaneada. Si una copia de proyecto homónima oculta la del Hub, audit sigue escaneando el path del lock file mientras /ascii-art carga la copia del proyecto; revisa los archivos completos del path activo o usa otro Skill oficial sin shadowing. En una instalación Hub aplicable, corrige archivos ausentes, paths inválidos o findings de riesgo antes de la tarea.

/ascii-art

Si Hermes reconoce el comando y espera instrucciones, el registro de la sesión funciona. Esta prueba explícita elimina la incertidumbre del enrutamiento por lenguaje natural.

4. Ejecutar una tarea real, guardar y aceptar el resultado

Envía en esa misma sesión:

/ascii-art Usa el fallback de generación personalizada para crear un banner que escriba HERMES solo con caracteres ASCII. No instales paquetes ni uses servicios de red. Devuelve exactamente un bloque de texto cercado, con un máximo de 60 caracteres de ancho y 15 líneas de alto.

Es una tarea síncrona: no hay job ID ni polling. Espera la respuesta del mismo turno y guarda únicamente el contenido del bloque como hermes-ascii.txt.

Guarda este validador como validate_ascii.py:

from pathlib import Path

path = Path("hermes-ascii.txt")
text = path.read_text(encoding="utf-8")
lines = text.splitlines()
width = max((len(line) for line in lines), default=0)
ascii_only = text.isascii()
print({"lines": len(lines), "max_width": width, "ascii_only": ascii_only})
raise SystemExit(not (lines and len(lines) <= 15 and width <= 60 and ascii_only))

Después ejecútalo:

python validate_ascii.py

La tarea pasa cuando /ascii-art se reconoce, HERMES es legible, el archivo no está vacío, el script muestra ascii_only: True y termina con código 0, y no se pidió paquete, red ni credencial. La forma de las letras puede variar; el contrato medible no.

La comprobación ASCII es obligatoria: el custom fallback oficial incluye caracteres Unicode de líneas y bloques, por lo que medir solo alto, ancho y legibilidad aceptaría erróneamente algo como HERMES ░. Si ascii_only es False, repite el mismo prompt pidiendo sustituir todo carácter no ASCII, sobrescribe el archivo y vuelve a ejecutar el validador.

5. Diagnóstico por síntoma

Síntoma	Primera comprobación	Corrección y nueva prueba
La búsqueda no encuentra el objetivo	Consulta o filtro demasiado estrecho	Amplía términos, copia el identifier nuevo y ejecuta inspect
inspect funciona, pero falla la descarga	Archivos movidos, red o rate limit	Busca de nuevo; no adivines repetidamente una ruta antigua
El escaneo bloquea la instalación	Verdict, archivo y tipo de riesgo	Detén la instalación, revisa el contenido o elige otro Skill
La lista lo muestra, pero falta /ascii-art	La sesión empezó antes de instalar	Abre otra sesión o /reset; usa --now en la instalación del chat cuando haga falta
El comando funciona, pero una frase libre no	El router no eligió el Skill	Usa primero /ascii-art <tarea> y prueba el lenguaje natural por separado
Se carga otro contenido con el mismo nombre	El path efectivo puede ser una copia de proyecto mientras audit revisó el lock path del Hub	Revisa .hermes/skills/ y .agents/skills/, abre los archivos completos de la copia activa y no uses el audit del Hub oculto como prueba del contenido de /ascii-art
La tarea quiere instalar o conectarse	Se eligió pyfiglet, cowsay o una ruta web	Repite el prompt y exige custom fallback sin instalación ni red
Cambió el audit de una instalación Hub	Cambiaron o se actualizaron archivos del Hub lock path	Deja de usarla, identifica el cambio, repite audit y la misma tarea mínima
El Skill no aparece en otra plataforma (CLI/Telegram/Discord)	Puede estar desactivado para esa plataforma o tener una restricción incompatible en platforms	Revisa la activación o desactivación específica de CLI, Telegram o Discord y el platforms del Skill; corrige el ajuste, abre una sesión nueva en esa plataforma y repite la misma tarea mínima

Cambia una sola variable y repite siempre la tarea HERMES. Así sabrás si el fallo está en descubrimiento, instalación, carga de sesión, routing o ejecución.

6. Elegir por tarea, no por una lista genérica de “mejores Skills”

Pregunta si el Skill resuelve el trabajo actual, si inspect aclara permisos y dependencias, si la fuente es rastreable, si existe una señal de éxito repetible y si se puede detener antes de escribir en un sistema externo. Para empezar, prioriza entradas pequeñas, permisos mínimos y una salida que puedas guardar.

Lista final

• La búsqueda devolvió un identifier completo.
• Trataste inspect como vista previa truncada y leíste SKILL.md y archivos auxiliares completos de la fuente y versión exactas.
• Cuando hacía falta decidir antes de copiar, usaste la CLI interactiva y leíste verdict y findings.
• Usaste una sesión nueva; --now en chat solo después de la revisión completa y aceptando que no hay confirmación post-scan.
• Confirmaste la fuente activa con hermes skills list; audit solo se ejecutó para una instalación Hub registrada y no oculta.
• Invocaste /ascii-art, guardaste hermes-ascii.txt y superaste tamaño, ASCII-only y legibilidad.
• Cada fallo se asignó a una capa y se volvió a probar con la misma tarea.

Con esto no solo demuestras que existe una carpeta: pruebas que el Skill puede encontrarse, comprenderse, superar el control de instalación, cargarse en una sesión, ejecutar una tarea y dejar una salida verificable.

Fuentes oficiales

• Working with Skills
• Optional Skills
• ASCII Art Skill
• Skills System