# Skills de Hermes Agent: cómo instalar y crear tu propio skill > Directorios y GitHub, el formato SKILL.md, /learn, la comprobación, actualización y eliminación de skills de Hermes Agent, con ejemplos completos de comandos. Source: https://ailoot.ai/blog/es/hermes-agent-skills/ Canonical: https://ailoot.ai/blog/es/hermes-agent-skills/ Language: es Publisher: Ailoot (https://ailoot.ai/) Translation: guide-117 Revision: sha256-fe55c553fb87a1fc300ab88b9fa9decd93779eeea2f8e4e2defa95ab5b3b49e3 Un skill es una instrucción guardada para un agente: describes una vez cómo realizar una tarea y, a partir de entonces, Hermes la aplica cuando llamas a `/skill-name`, sin que tengas que repetir las explicaciones. Puedes instalar un skill listo para usar con un solo comando y crear uno propio de dos maneras: escribir SKILL.md manualmente o usar `/learn`. Si aún no has instalado Hermes, empieza con la guía [qué es este agente y cómo instalarlo](https://ailoot.ai/blog/es/hermes-agent-install-setup/) y después pasa a los skills.
Encontrarás instrucciones prácticas para usar Ailoot en la [documentación](https://ailoot.ai/docs/).
## ¿Qué es un skill en Hermes Agent?
Lo esencial Un skill es un archivo con instrucciones para un agente: qué hacer, qué comandos usar, a qué prestar atención y dónde suelen producirse errores. Se guarda en la carpeta `~/.hermes/skills/` como un archivo SKILL.md, junto con cualquier material complementario. Tras instalarlo, el skill se convierte automáticamente en un comando `/name` en cualquier chat con el agente.
Escribes una instrucción en un mensaje para el agente. El skill se guarda en un archivo aparte y Hermes puede usar esa instrucción en tareas futuras. El agente tiene acceso a una lista de nombres y descripciones, y carga el texto completo del skill cuando es pertinente para la tarea. Así se ahorra espacio en el contexto: no se cargan todas las instrucciones a la vez. Un skill por sí solo no proporciona al agente herramientas ni acceso nuevos; describe cómo usar las herramientas que ya tiene. Una nueva integración con un servicio externo se gestiona mediante MCP, que es un tema aparte. Si una tarea requiere lógica de programa precisa, autorización especial o procesamiento de flujos de eventos, necesita herramientas de agente; un skill por sí solo no basta. Para una tarea habitual, elige un skill listo para usar si sus instrucciones encajan y se ha comprobado su origen. Crea uno propio cuando necesites conservar una secuencia concreta de acciones, restricciones y un formato de salida. Usa `/learn` si ya tienes materiales o has completado un proceso y no quieres escribir el archivo manualmente.

Los skills son documentos que contienen información que un agente necesita y que carga solo cuando hace falta.

— Documentación de Hermes Agent (traducida del inglés), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
El formato es abierto y compatible con la [especificación Agent Skills](https://agentskills.io/specification), así que los skills de otros catálogos suelen funcionar en Hermes sin cambios de formato, aunque un skill concreto puede requerir sus propias herramientas o claves. También puedes compartir tu skill si quieres. ## ¿Qué skills están instalados y dónde se guardan?
Lo esencial De forma predeterminada, los skills se guardan en la carpeta `~/.hermes/skills/`, organizados en subcarpetas por categoría (si usas un perfil no estándar o la variable HERMES_HOME, la ruta será distinta; `hermes config path` te la mostrará). Tras la instalación, Hermes ya incluye decenas de skills integrados, desde buscar en arXiv hasta trabajar con GitHub y documentos. El comando `hermes skills list` muestra la lista, y puedes preguntarle al agente en el chat qué skills tiene.
La carpeta está organizada así: ``` ~/.hermes/skills/ ├── research/ │ └── arxiv/ │ ├── SKILL.md │ └── scripts/ ├── productivity/ │ └── pdf/ │ ├── SKILL.md │ └── references/ └── .hub/ ``` SKILL.md es el único archivo obligatorio. Todo lo demás se añade según haga falta: `references/` para materiales más extensos, `scripts/` para programas auxiliares y `templates/` y `assets/` para plantillas y archivos. El catálogo integrado incluye skills para tareas cotidianas: buscar GIF, trabajar con PDF, hojas de cálculo, YouTube, GitHub y notas. La lista completa con descripciones está en la página del [catálogo de skills integrados](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog). Cada vez que ejecutas `hermes update`, Hermes también actualiza los skills integrados y conserva tus cambios. ## ¿Cómo se instala un skill listo para usar del catálogo?
Lo esencial Abre el catálogo con `hermes skills browse`, encuentra lo que necesitas con `hermes skills search`, consulta la ficha de un skill con `hermes skills inspect` e instálalo con `hermes skills install`. Todos los skills pasan por una comprobación de seguridad antes de instalarse, y los oficiales no generan una advertencia sobre fuentes de terceros.
1. ### Busca en el catálogo ```bash hermes skills search pdf ``` La búsqueda abarca todas las fuentes conectadas. Para ver el catálogo completo sin filtros, ejecuta `hermes skills browse`. 2. ### Consulta la ficha del skill ```bash hermes skills inspect skills-sh/anthropics/skills/pdf ``` La ficha muestra la descripción, el origen y el nivel de confianza. No instales un skill de otra persona sin leer su ficha. 3. ### Instálalo ```bash hermes skills install skills-sh/anthropics/skills/pdf ``` Hermes descarga SKILL.md y los archivos complementarios, realiza una comprobación de seguridad y lo guarda todo en `~/.hermes/skills/`. El skill queda disponible de inmediato como comando `/pdf`. Si necesita herramientas o claves adicionales, se indican en su archivo SKILL.md y Hermes te lo dirá durante la instalación. La comprobación de seguridad busca intentos de enviar datos al exterior, instrucciones inyectadas para el agente y comandos que podrían borrar o dañar archivos. Las fuentes tienen distintos niveles de confianza: | Nivel | Fuente del skill | Qué ocurre durante la instalación | |----|----|----| | Integrado | Incluido con Hermes | Ya está disponible; no hace falta instalarlo | | Oficial | Carpeta de skills opcionales del repositorio de Hermes | Se instala sin una advertencia sobre fuentes de terceros: `hermes skills install official/security/1password` | | De confianza | Los repositorios openai/skills, anthropics/skills, huggingface/skills y NVIDIA/skills | Comprobación menos estricta | | Otros | Catálogos, repositorios GitHub de otras personas, enlaces directos | Advertencia y comprobación completa | Si la comprobación emite una advertencia, puedes continuar la instalación con la opción `--force`, pero primero lee qué riesgo ha detectado. No se puede eludir un veredicto de «peligroso». La comprobación por sí sola no garantiza la seguridad: antes de ejecutar por primera vez un skill de otra persona, lee sus instrucciones y los comandos asociados. ## ¿Cómo se instala un skill desde GitHub o mediante un enlace?
Lo esencial Instala un skill desde GitHub con `hermes skills install owner/repository/path` o usa un enlace directo a un archivo SKILL.md; Hermes descargará los archivos que lo acompañan. Puedes conectar tu propia fuente de skills con `hermes skills tap add`; después funcionará como cualquier otro catálogo.
Hay tres formas de instalarlo: ```bash # 1. Un skill concreto de un repositorio GitHub (su ruta dentro del repositorio va después del nombre) hermes skills install anthropics/skills/skills/pdf # 2. Un enlace directo a un SKILL.md en cualquier sitio (comparte este skill en un chat) hermes skills install '' # 3. Conectar un repositorio entero como fuente (sustituye por tu propietario y repositorio) hermes skills tap add myorg/skills-repo hermes skills install myorg/skills-repo/deploy-runbook ``` Con un enlace directo, Hermes descarga SKILL.md y solo los archivos de las subcarpetas del servicio que se mencionan en él; no descarga archivos del sitio que no estén relacionados. El enlace se guarda como fuente, y más adelante `hermes skills update` actualizará el skill desde esa misma dirección. Además de GitHub, puedes conectar catálogos externos de skills. Puedes encontrar skills en ellos con el mismo comando `hermes skills search`, indicando la fuente.
Atención GitHub limita a 60 por hora las solicitudes sin autenticar. Si recibes errores de límite al instalar o buscar, añade `GITHUB_TOKEN` al archivo `~/.hermes/.env`; el límite aumentará a 5000 solicitudes por hora.
## ¿Cómo se usa un skill después de instalarlo?
Lo esencial Un skill instalado se convierte automáticamente en un comando: escribe `/skill-name` y la tarea en la misma línea. No hace falta activarlo por separado. Funciona en el terminal, la interfaz web y las aplicaciones de mensajería a través de la pasarela. Puedes invocar hasta cinco skills en un solo mensaje o convertir una combinación recurrente en un único comando.
Escribe los comandos `hermes ...` en el terminal y las invocaciones `/skill-name` en un chat con el agente (en ese mismo terminal, en la interfaz web o en una aplicación de mensajería): ``` /gif-search funny cats /github-pr-workflow create a PR for the authorization rewrite ``` Si escribes `/skill-name` sin una tarea, Hermes cargará las instrucciones y te preguntará qué quieres que haga. Puedes invocar varios skills en una línea, hasta cinco; el texto restante se convierte en la tarea: ``` /github-pr-workflow /test-driven-development close issue 123 and open a PR ``` Para las combinaciones que usas con frecuencia, hay grupos de skills llamados bundles en la terminología de Hermes: `hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development` agrupa varios skills bajo un comando breve `/backend-dev`. Ese bundle actúa como un alias; primero hay que instalar los skills que contiene. Los comandos slash también funcionan en Telegram si la pasarela está conectada; la configuración se explica en la guía [cómo conectar Hermes Agent a Telegram](https://ailoot.ai/blog/es/hermes-agent-telegram-setup/). También es una forma práctica de ejecutar skills desde el teléfono. ## ¿Cómo crear un skill propio y qué debe incluir SKILL.md?
Lo esencial Tu propio skill es una carpeta en `~/.hermes/skills/` con un archivo obligatorio, SKILL.md: un encabezado breve con un nombre y una descripción, seguido de instrucciones organizadas en secciones: cuándo usarlo, la secuencia de acciones, errores frecuentes y verificación. Está escrito en texto sin formato; no hace falta programar. Para una versión sencilla, basta con una carpeta y un archivo.

Los skills son la principal forma de añadir nuevas capacidades a Hermes Agent: son más fáciles de crear que las herramientas, no requieren cambios en el código del agente y se pueden compartir con la comunidad.

— Documentación de Hermes Agent (traducida del inglés), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills
Puedes copiar este skill y adaptarlo a tus necesidades: ```markdown --- name: weekly-review description: Weekly review: what got done, what stalled, plan for next week version: 1.0.0 metadata: hermes: tags: [planning, review] --- # Weekly review ## When to Use When the user asks to review the week or put together a plan for the next one. ## Procedure 1. Get the week's task list from the file the user provided, or ask them for it. 2. Sort the tasks into three groups: done, stalled, and new. 3. Name three priorities for the coming week. ## Pitfalls - Don't invent tasks that aren't in the original list. ## Verification Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.” ``` El encabezado entre los tres guiones contiene los metadatos. Los campos principales son `name` (en letras latinas, con las palabras separadas por guiones y usado para invocar el skill como comando) y `description`. El agente utiliza el campo de descripción para decidir si el skill encaja con la tarea actual y si debe cargarlo. Si la descripción es vaga, puede que no cargue el skill cuando lo necesites. Después del encabezado vienen las secciones de instrucciones. `When to Use` indica cuándo cargar el skill. `Procedure` ofrece los pasos. `Pitfalls` recoge los errores habituales del agente y cómo evitarlos. `Verification` explica cómo comprobar el resultado. Si las instrucciones son largas, traslada el contenido principal a archivos en `references/`; se cargarán solo cuando haga falta. Pon los programas auxiliares en `scripts/`.
Consejo Pon el caso más habitual al principio y los casos poco frecuentes al final del archivo. Hermes lee los skills de arriba abajo, y este orden ahorra espacio en el contexto.
Si un skill necesita una clave de API, declárala en el encabezado mediante `required_environment_variables`; no incluyas la clave en el archivo, solo declara el nombre de la variable. Hermes te pedirá el valor una vez, en la primera invocación desde un terminal local, y después lo proporcionará automáticamente (en las aplicaciones de mensajería, te pedirá que configures la clave localmente). Los campos `platforms`, `config`, `blueprint` y otros se describen en la página oficial de documentación [Creating Skills](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills). Cuando el archivo esté listo, sigue estos pasos: 1. ### Crea la carpeta del skill ```bash mkdir -p ~/.hermes/skills/weekly-review ``` El nombre de la carpeta coincide con el campo `name` del encabezado. 2. ### Guarda SKILL.md Guarda en la carpeta un archivo llamado `SKILL.md` con tus instrucciones; puedes usar el ejemplo anterior y adaptarlo a tu tarea. 3. ### Invoca el skill y compruébalo Escribe `/weekly-review` y pide al agente que revise tu semana. Si sigue los pasos de tus instrucciones, el skill funciona. ## ¿Cómo crear un skill con /learn a partir de materiales existentes?
Lo esencial El comando `/learn` crea un skill a partir de materiales existentes: indícale una carpeta de documentación, el enlace a una página, tus notas o una descripción oral de un proceso, y Hermes redactará un archivo SKILL.md según las convenciones habituales para que lo revises. Un libro o un archivo extenso dará lugar a un skill con archivos separados por tema.
``` /learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication /learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills /learn how I just published a site to hosting ``` Si acabas de completar un proceso complicado con el agente, pídele a `/learn` que lo guarde como skill mientras todos los pasos siguen en la conversación. La próxima vez, Hermes repetirá el procedimiento con las instrucciones preparadas. Una fuente extensa, como un libro, una especificación o un archivo de documentos, no cabe en un solo archivo. Hermes creará un SKILL.md compacto con un mapa de temas y trasladará los detalles a `references/`. Estos archivos no ocupan espacio en el contexto hasta que el agente los carga para responder una pregunta. Si vuelves a ejecutar `/learn` sobre el mismo tema, se añadirá al skill existente en vez de crear un duplicado. ## ¿Cómo comprobar que un skill funciona?
Lo esencial Para comprobarlo, ejecuta `hermes chat --toolsets skills -q` y hazle una petición relacionada con el skill, como pedirle que revise una semana usando una lista de tareas. Si el agente organiza las tareas en los grupos de tus instrucciones, el skill funciona. Si responde como siempre, comprueba el nombre del archivo, la descripción del encabezado y la ubicación de la carpeta.
```bash hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment" ``` Esta es la prueba que recomienda la documentación: ejecuta el skill y comprueba que el agente siga tus instrucciones. Si no lo hace, revisa tres causas posibles. Primero, puede que el nombre de la carpeta o el campo `name` del encabezado no coincida con el nombre que invocas. Segundo, puede que la descripción no deje claro cuándo debe usarse el skill; vuelve a escribirla con las mismas palabras de la tarea. Tercero, puede que la carpeta no esté en `~/.hermes/skills/`, por lo que Hermes no puede encontrarla. Ten en cuenta que la opción `--toolsets skills` limita el conjunto de herramientas de la prueba: muestra cómo trabaja el agente con la instrucción, pero no comprueba las dependencias del skill, como los programas externos. `hermes skills list` en el terminal muestra exactamente lo que está instalado. Los skills forman parte de un clon de IA: permiten registrar una vez cómo realizas una tarea para que el agente pueda repetirla sin recordatorios. La combinación incluye **clon de IA + Segundo Cerebro + Ingeniería del Contexto**. Esta combinación ayuda a transmitir al agente tu lógica de trabajo y el contexto de la tarea. ## ¿Cómo actualizar y eliminar skills?
Lo esencial `hermes skills check` muestra qué skills instalados se han actualizado en su origen, `hermes skills update` descarga las nuevas versiones y `hermes skills uninstall name` elimina un skill. Las modificaciones que hagas en el skill de otra persona se conservan durante las actualizaciones: Hermes omite los archivos modificados. Puedes restaurar el original: para un skill del hub, usa `hermes skills update name --force`; para un skill integrado, usa `hermes skills reset name --restore`.
```bash hermes skills check # qué ha cambiado en las fuentes hermes skills update # descargar nuevas versiones hermes skills uninstall pdf # eliminar un skill del hub ``` Para eliminar un skill que hayas creado manualmente, borra su carpeta de `~/.hermes/skills/`. Si has personalizado el skill de otra persona, `update` lo dejará tal cual: Hermes compara los hashes y omite los archivos modificados para no sobrescribir tu trabajo. Para restaurar el original de un skill del hub, usa `hermes skills update name --force`; para un skill integrado, usa `hermes skills reset name --restore`. Ambos comandos sobrescriben tus cambios, así que guarda primero tu versión. Si no necesitas los skills integrados y te saturan la lista, `hermes skills opt-out` desactivará su incorporación durante las actualizaciones. El comando `opt-out --remove` también eliminará los que no hayas modificado. ## ¿Qué hacer si un skill no se instala o no funciona?
Lo esencial Hay tres obstáculos habituales: el límite de GitHub de 60 solicitudes por hora, el bloqueo de la instalación por la comprobación de seguridad y la ubicación incorrecta del archivo. Si alcanzas el límite, añade `GITHUB_TOKEN`. Si la comprobación bloquea la instalación, lee su veredicto. Si Hermes no encuentra el skill, comprueba si está en `~/.hermes/skills/`.
| Síntoma | Causa | Qué hacer | |----|----|----| | Errores de límite al buscar o instalar | Sin un token, GitHub permite hasta 60 solicitudes por hora | Añade `GITHUB_TOKEN` a `~/.hermes/.env` | | Instalación bloqueada | La comprobación detectó un riesgo en el código del skill | Lee el resultado de la comprobación durante la instalación; para volver a comprobar un skill instalado, ejecuta `hermes skills audit`. Si es una advertencia, puedes continuar con `--force`; si el veredicto es «peligroso», no puedes | | El skill está instalado, pero `/name` no funciona | El nombre no coincide o la carpeta está en otra ubicación | Ejecuta `hermes skills list` y comprueba la carpeta `~/.hermes/skills/` | | El skill ni siquiera aparece en la lista | Su SKILL.md impone una restricción de plataforma o de herramientas necesarias | Abre su SKILL.md y comprueba los campos `platforms` y `requires_*` | | La nueva versión del skill no se descargó tras la actualización | Cambiaste el archivo localmente y Hermes conserva tus modificaciones | Si necesitas el original, usa `update name --force` para un skill del hub o `reset --restore` para uno integrado; si prefieres conservar tu versión, no hagas nada | | No se cargan skills de otro repositorio | El repositorio debe marcarse como de confianza | Ejecuta `hermes skills trust` dentro del repositorio | Hermes encuentra skills en las carpetas `.hermes/skills/` y `.agents/skills/` de un repositorio Git. Antes de cargarlos, tienes que marcar el repositorio como de confianza: estos archivos contienen instrucciones que seguirá el agente. Después, los skills del repositorio solo funcionan dentro de él y pasan por la misma comprobación de seguridad. Solo tienes que marcar el repositorio como de confianza una vez. ## ¿Qué deberías hacer primero?
Lo esencial Instala un skill listo para usar del catálogo; solo necesitas un comando. Después, toma una instrucción que repites, pásasela a `/learn` y comprueba el resultado con una tarea real de tu trabajo.
Para continuar con este tema: [cómo conectar Hermes Agent a Telegram](https://ailoot.ai/blog/es/hermes-agent-telegram-setup/), para que puedas invocar skills desde el teléfono, y [cómo mantener un agente funcionando en un servidor las 24 horas](https://ailoot.ai/blog/es/hermes-agent-vps-24-7/), si quieres usar skills programados. Si estás eligiendo un agente, consulta la comparación [OpenClaw o Hermes Agent](https://ailoot.ai/blog/es/openclaw-vs-hermes-agent/).
### Fuentes - [Documentación de Hermes Agent](https://hermes-agent.nousresearch.com/docs/) - [Sistema de skills: cómo funcionan los skills](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) - [Crear skills: cómo escribir tu propio skill](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) - [Catálogo de skills integrados](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog) - [Skills opcionales oficiales](https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog) - [Repositorio de Hermes Agent en GitHub](https://github.com/NousResearch/hermes-agent) - [Estándar abierto Agent Skills](https://agentskills.io/specification)
Puedes seguir explorando Ailoot en [ailoot.ai](https://ailoot.ai/).
## Preguntas sobre Hermes Agent ### ¿Por qué una skill instalada no aparece como comando con barra? Comprueba la lista de skills instaladas, el nombre de archivo SKILL.md, su campo name y la carpeta de skills del perfil activo. Las restricciones de plataforma, herramientas requeridas o confianza del repositorio también pueden impedir cargarla. ### ¿La prueba limitada de skills verifica todas las dependencias? No. Una prueba solo de skills comprueba si el agente carga y sigue la instrucción. Revisa aparte herramientas, programas y claves necesarios y verifica un resultado real acotado antes de usar el flujo completo. ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.