Skills de Hermes Agent: chuleta de objetivos y creación de posts

Las skills son atajos de lenguaje. En lugar de explicarle a Hermes paso a paso lo que quieres, escribes una frase corta y él ya sabe qué hacer: conoce las reglas de tu vault, los 22 campos obligatorios del frontmatter y qué comandos validan el resultado.

Esta guía va al grano: qué escribir para conseguir cada objetivo. Está pensada para usarse desde la app de Hermes Agent, aunque casi todo funciona igual desde Obsidian o la terminal.

La idea central es simple: una frase tuya activa un flujo completo. Tú pides el resultado; la skill se encarga del método.

No necesitas saber qué skill existe ni cómo se llama. Describe lo que quieres y Hermes elige la habilidad adecuada.

❌ No escribas: “lee el frontmatter-spec, luego abre el archivo y añade los campos que faltan”.
✅ Sí escribe: “arregla el frontmatter de esta nota”.

Cuanto más concreto sea tu objetivo, mejor será el resultado. Menciona siempre el tema, la categoría y, si aplica, el nombre o slug de la nota.

Truco: si no recuerdas el nombre exacto de una nota, descríbela (“la nota del aura”) y Hermes la localizará en el índice del vault.

Casi todo se puede pedir de tres formas, y las tres hablan con el mismo motor: el mismo canon de skills.

Vía	Cómo se pide	Cuándo te conviene
App de Hermes Agent	Una frase en objetivos («crea un post sobre…»)	Es la cómoda: recuerda el vault y confirma antes de escribir
Cline, dentro de VS Code	Pídeselo igual, en el chat del editor	Cuando estás dentro del repo, viendo los archivos
Terminal (`npm`)	`npm run <comando>`	Cuando quieres el resultado exacto y sin conversación

Las skills se proyectan solas a Cline (npm run skills:cline), así que allí también entiende «arregla el frontmatter» o «enlaza este post» sin que se lo expliques. Y los mismos controles existen en la terminal, para quien prefiera escribir el comando: están en la tabla de validación (§9).

Cada skill tiene aquí su ficha pública —Contexto del vault, Frontmatter del post, SEO on-page…— y el mapa de las catorce está en la tabla de atajos (§14).

Esta tabla es el corazón de la guía. Copia la frase, cámbiala por tu tema y listo.

Quiero…	Escribe esto	Qué hará Hermes
Crear un post completo	`Crea un post sobre "El silencio en Humano" en Humano`	Frontmatter + contenido + wikilinks + SEO + validación
Crear solo el esqueleto	`Créame un borrador vacío sobre X en Máquina`	Nota lista para rellenar, sin redacción automática
Ampliar un post corto	`Amplía la nota el-aura, se queda corta`	Desarrolla secciones manteniendo el tono
Mejorar la redacción	`Mejora el estilo de la nota doc-guia sin cambiar el significado`	Reescribe con el estilo del vault
Arreglar el frontmatter	`Revisa el frontmatter de esta nota y completa lo que falte`	Valida los 22 campos y corrige
Añadir wikilinks	`Enlaza los conceptos de la nota la-respiracion`	Inserta enlaces con alias
Arreglar enlaces rotos	`Corrige los wikilinks sin alias del vault`	Aplica la Regla de Oro
Revisar el SEO	`Audita el SEO de la nota hermes-agent`	Title, description, tags, imagen, canonical
Renombrar el slug	`Cambia el slug de esta nota a silencio-biodanza`	Renombra y actualiza los backlinks
Validar todo el vault	`¿Cómo está de salud el vault?`	Informe con métricas y prioridades
Publicar el sitio	`Publica el sitio`	Build completo y despliegue
Buscar algo	`Busca "respiración" en los posts`	Devuelve las notas donde aparece
Ver relacionadas	`¿Qué notas se relacionan con el-aura?`	Ranking por afinidad temática
Probar en el móvil	`Levántame el server para verlo en el móvil`	Dev server en la LAN + túnel HTTPS, con los dos enlaces

Para la app: escribe la frase tal cual, sin comillas ni formato especial. Las comillas solo hacen falta alrededor del texto que quieres que sea literal, como el tema.

La app es el punto de entrada más cómodo porque la conversación tiene contexto: puedes pedir un cambio y luego iterar sobre el resultado sin repetir nada.

El flujo típico de tres turnos:

Pides → “Crea un post sobre el grounding en Humano”.
Revisas → Hermes te muestra la propuesta completa (frontmatter + texto + enlaces) y espera tu confirmación. Aquí no ha escrito nada todavía.
Confirmas → respondes sí, o pides modificar para retocar, o cancela para descartar.

Esos tres verbos son los que gobiernan todo:

Tu respuesta	Qué ocurre
`sí`	Escribe la nota en el vault
`modificar`	Te pregunta qué cambiar y vuelve a proponer
`cancela`	Descarta sin tocar nada

Este freno es intencionado: Hermes nunca escribe en tu vault sin permiso. Si te precipitas y quieres parar, escribe cancela.

Da la categoría siempre. Es el dato que más se olvida y el que más condiciona el tono.
Un objetivo por mensaje. “Crea el post y publícalo” suele salir peor que dos turnos separados.
Itera sin repetir contexto. Tras crear una nota, basta con decir “ahora amplía la sección 2”.
Si algo no encaja, dilo en lenguaje natural. “El tono es demasiado técnico” es una instrucción perfectamente válida.

Cuando pides un post completo, Hermes ejecuta seis pasos encadenados. No tienes que hacer nada, pero conocerlos te ayuda a pedir mejor las cosas.

Contexto — carga las reglas del vault y el índice de notas existentes.
Frontmatter — genera los 22 campos obligatorios.
Contenido — redacta el cuerpo siguiendo el estilo del vault.
Wikilinks — inserta los enlaces internos con su alias.
SEO — revisa title, description, tags e imagen.
Validación — comprueba que todo cumple las reglas antes de entregártelo.

El orden importa: los aliases del frontmatter (paso 2) crean destinos enlazables, así que los wikilinks (paso 4) se resuelven mejor cuando ya existen.

Dato	Obligatorio	Ejemplo
Tema	Sí	`el grounding en Humano`
Categoría	Sí	`Humano`
Enfoque	Recomendado	`desde la práctica, no la teoría`
Longitud	Opcional	`corto` (~400-800 palabras)
Tags	Opcional	`grounding, cuerpo, presencia`

Con tema y categoría ya funciona. Lo demás afina el resultado.

Si tu tema ya existe en el vault, dilo: “sobre el grounding, sé que ya hay algo, úsalo como base”. Así Hermes enlaza con lo que ya tienes en lugar de crear islas de contenido.

Aquí es donde más se aprovecha la app, porque cada iteración construye sobre la anterior.

Amplía la nota silencio-biodanza, la sección de práctica se queda corta
Desarrolla dos párrafos más en la introducción
Añade una sección sobre cómo empezar mañana mismo

Hermes mantiene el tono y la estructura, y no toca lo que ya funciona. Si quieres que respete algo, dilo: “no cambies la introducción”.

Mejora el estilo de esta nota, se nota repetitiva
Hazlo más divulgativo, demasiado técnico para Humano
Acorta los párrafos, hay varios que pasan de 6 líneas

Las reglas del vault piden párrafos de máximo 6 líneas, tono accesible y frases sin juicios absolutos (“puede”, “suele” en lugar de “siempre”, “nunca”). Si pides algo que contradice esas reglas, Hermes te lo dirá antes de aplicarlo.

Pide los cambios en lenguaje natural y de forma quirúrgica:

✅ “En la sección 2, cambia el ejemplo del agua por uno de respiración”.
✅ “Sustituye la mención a X por Y”.
❌ “Reescribe toda la nota” — solo si de verdad quieres rehacerla.

El frontmatter es la cabecera YAML de la nota y tiene 22 campos, pero solo 4 bloquean (title, slug, description y categories). Los demás traen valor por defecto: si falta uno, se anota como aviso y nada se rompe.

Desde septiembre de 2026 hay dos títulos con funciones distintas, y confundirlos es el error más típico:

concept — la etiqueta CORTA (1-4 palabras). Es lo que ves: el titular del artículo, las tarjetas de los listados, las etiquetas del grafo y los tooltips.
title — el título LARGO (50-75 caracteres) con valor SEO. No se ve en pantalla: es lo que aparece en Google, en la pestaña del navegador y al compartir el enlace. Arranca por la palabra clave del concept.

Revisa el frontmatter de esta nota y dime qué falta
Completa el frontmatter de doc-buscador
Cambia la description de esta nota, es muy corta
Añade 3 aliases a esta nota

Campo	Para qué sirve	Regla práctica
`concept`	Etiqueta corta visible	1-4 palabras (≤60 caracteres)
`title`	Título SEO	50-75 caracteres, palabra clave al principio
`slug`	URL de la nota	Minúsculas, guiones, sin acentos, ≤3 palabras
`description`	Resumen para Google	140-200 caracteres (≥12 palabras), con palabra clave
`categories`	Categoría	Una de las 5 fijas: `Humano`, `Documentación`, `Literatura`, `Opinión`, `Máquina`
`tags`	Etiquetas	2-6, minúsculas, sin tildes, con guiones
`aliases`	Variantes del título	2-3; además sirven como destino de enlaces
`pubDate` / `updatedDate`	Fechas	Formato `YYYY-MM-DDTHH:mm:ss.000Z`
`image` / `imageAlt`	Portada	`/img/<slug>.webp` o `/img/placeholder.webp`

Las cinco categorías válidas son siempre las mismas: Humano, Documentación, Literatura, Opinión y Máquina. No se inventan nuevas sin hablarlo antes.

Ojo con description: es lo que más se sale de rango. Por debajo de 140 caracteres (y por encima de 200) el fragmento de Google sale pobre o truncado; fuera de 100-260 el gate solo avisa (no bloquea). Pide “revisa la description” y Hermes te propondrá una versión de la longitud correcta.

Los wikilinks conectan tus notas entre sí. Son la diferencia entre un blog y una red de conocimiento. En este vault son tan importantes que existe una nota entera dedicada a pensar mejor con Obsidian y otra al flujo de generación de contenido.

La regla es una sola: todo enlace dentro de un párrafo debe llevar texto visible.

Correcto	Incorrecto
`[[el-aura\|el aura]]`	`[[el-aura]]`

Este es el detalle que más se incumple y el linter lo detecta como error. La razón es de lectura: [[el-aura]] se ve como un slug con guiones, mientras que [[el-aura|el aura]] se lee con naturalidad.

Enlaza los conceptos de la nota la-respiracion
Corrige los wikilinks sin alias de esta nota
Enriquece los enlaces del post hermes-agent
Dime qué conceptos de esta nota merecen su propia nota

Párrafo	Máximo
Corto (menos de 3 líneas)	1 enlace
Medio (3-6 líneas)	2 enlaces
Largo (más de 6 líneas)	3 enlaces
Introducción	2-3 enlaces (excepción)

El objetivo es 3-6 enlaces por post. Más no es mejor: si cada palabra es un enlace, el texto se vuelve ilegible.

Conceptos sin nota propia: son los llamados huérfanos. No son un error; son ideas que merecen su propio post en el futuro. Pide “dime los huérfanos prioritarios” y Hermes te dirá cuáles aparecen en más notas y por tanto conviene crear primero.

Antes de publicar conviene pasar el control de calidad.

¿Está bien esta nota?
Valida el frontmatter y los enlaces de este post
Revisa si los enlaces de esta nota apuntan a sitios reales

Hermes comprueba tres cosas por ti: que el frontmatter tenga lo que el build necesita (los 4 campos duros; del resto solo se avisa), que los enlaces cumplan la Regla de Oro y que el SEO esté en orden.

Ninguno de esos gates bloquea por redacción: solo lo que de verdad rompe el sitio (un campo duro ausente, un tipo imposible, un corchete roto en un enlace). Las longitudes, los alias que faltan y el estilo del title se listan como aviso y se corrigen cuando toca, no antes de publicar.

El linter de enlaces mira tres cosas: que la sintaxis no esté rota (un [slug] suelto, un corchete de más), que es lo único que bloquea; que el destino exista, que es aviso; y que cada enlace lleve alias descriptivo, también aviso: sin alias, el enlace se pinta con la etiqueta corta de la nota destino, así que se pierde tu texto de enlace, no la lectura.

Comando mental: “valida esta nota” siempre es una buena idea antes de decir sí a una publicación.

Los mismos controles se pueden lanzar desde la terminal: son los que corren antes de cada publicación.

Comando	Qué mira	Si sale rojo
`npm run verify:content`	Todo de golpe: frontmatter, SEO, slugs, enlaces, libros y medios	No se publica; se corrige el contenido
`npm run validate:frontmatter`	Los 22 campos (los 4 duros bloquean)	Falta un campo duro: se añade
`npm run validate:seo`	`title`, `description` y títulos repetidos	Solo bloquea un `title` duplicado
`npm run validate:wikilinks`	La sintaxis, el destino y el alias de cada enlace	Bloquea el corchete roto; lo demás es aviso
`npm run tools:auditar`	Salud del vault: huérfanos, tags y enlaces	No cambia nada: te ordena prioridades

De verde no hay sorpresas: si verify:content pasa, el sitio se puede publicar.

Cuando llevas muchas notas, conviene revisar el conjunto.

¿Cómo está de salud el vault?
Dame los huérfanos prioritarios
¿Qué tags debería consolidar?
¿Qué notas están desactualizadas?

Recibirás un nivel de salud (excelente, buena, regular o mala) calculado con métricas reales, más una lista de acciones ordenadas por prioridad. Hermes no modifica nada: te propone y esperas tú.

Cuántas notas tienen enlaces internos.
Cuántos conceptos están sin nota propia.
Si los tags están normalizados (sin tildes ni almohadillas).
Si hay borradores olvidados.

Publica el sitio

Por debajo, esa frase lanza npm run deploy: valida el vault, construye el sitio, hace el commit y lo sube a GitHub. Cloudflare despliega solo en 1-3 minutos; si al recargar ves la versión de antes, espera un poco más.

Antes de publicar, casi todo se juzga mejor con el teléfono en la mano: una tipografía, una animación, un gráfico. Para eso está el dev tunnel, que levanta el servidor de desarrollo en tu red y le abre un túnel HTTPS, así que te devuelve dos enlaces —el de la WiFi y el público—.

Levántame el server para probarlo en el móvil
Arranca dev:tunnel y mándame los enlaces

La segunda frase te los manda al chat, que en el móvil es lo cómodo: los abres tocándolos. Por debajo, todo eso es npm run dev:tunnel, y a su alrededor hay tres comandos más:

Comando	Para qué
`npm run dev:tunnel`	Levanta el servidor y el túnel, y devuelve los dos enlaces
`npm run dev:tunnel:status`	¿Sigue vivo? (exit 0 = sí: vale como gate de un `/goal`)
`npm run dev:tunnel:setup`	¿Qué IP y qué túneles hay en esta máquina? (no levanta nada)
`npm run dev:tunnel:stop`	Para las dos cosas cuando termines

Dos avisos que ahorran sustos: cerrar la terminal no lo para (se para con el comando) y, mientras el dev server vive, el build no limpia su caché de render, así que lo suyo es pararlo antes de publicar.

El paso a paso con ejemplos, cuándo abrir el enlace de la WiFi y cuándo el del túnel, y qué hacer si algo falla están en el post Dev tunnel; la ficha de la habilidad, en Dev server y túnel.

Situación	Qué hacer
No entiende el tema	Repite el objetivo en una frase más concreta
Está escribiendo algo que no quieres	Escribe `cancela` inmediatamente
El tono no encaja	“Demasiado técnico, hazlo más cercano”
Falta información	“Pregúntame lo que necesites antes de escribir”
Cita una nota que no existe	“Enlaza solo a notas que ya existan en el vault”
Se olvidó de la categoría	“Cámbiala a Documentación”
El resultado es muy largo	“Reduce a la mitad, quédate con lo esencial”

La regla que resuelve casi todo: si el resultado no te sirve, dilo y vuelve a pedir. Nada se escribe en el vault hasta que confirmas, así que equivocarse no cuesta nada.

Cuando no quieras explicar el proceso, hay tres atajos (los bundles del sistema): cargan varias skills de golpe y son la forma corta de pedir un flujo entero.

Atajo	Qué le pides	Va por dentro
`/markeup-post`	Crear una nota completa	contexto → frontmatter → cuerpo → enlaces → medios → imagen → SEO → gate
`/markeup-publish`	Publicar con auditoría	salud del vault → correcciones → gate → `build` → despliegue
`/markeup-verify`	Mirar el estado, sin tocar nada	`doctor` → `verify:content` → `images:check` → `tools:auditar`

Y estas son las catorce skills que hay detrás, cada una con su ficha pública en esta sección y una frase con la que pedirla:

Skill	Qué sabe hacer	Cómo se pide
[[skill-context	Contexto del vault]]	Rutas, reglas y protocolo de entrada: por dónde empieza todo
[[skill-frontmatter	Frontmatter del post]]	Los 22 campos YAML y los 4 que de verdad bloquean
[[skill-content	Cuerpo del artículo]]	Tono, estructura y formato del texto
[[skill-wikilinks	Wikilinks del vault]]	Enlaces internos con alias descriptivo y su densidad
[[skill-media	Medios embebidos]]	Vídeo, audio, libro y película como bloque
[[skill-images	La imagen del post]]	La portada: una sola fuente por nombre y sus variantes
[[skill-seo	SEO on-page]]	`title`, `description` y títulos duplicados
[[skill-audit	Salud del vault]]	Mide huérfanos, tags y borradores; prioriza sin tocar nada
[[skill-routes	Rutas del sitio]]	URL, redirecciones 301 y contexto de sección
[[skill-graphs	Grafos 2D y 3D]]	Los dos mapas de notas, con un solo cerebro
[[skill-motion	Movimiento y animación]]	Qué se anima, qué no y por qué
[[skill-cli	Comandos del proyecto]]	La CLI: `validate:`, `build`, `tools:`
[[skill-deploy	Publicar el sitio]]	Commit, push a `main` y despliegue en Cloudflare
[[skill-devtunnel	Dev server y túnel]]	El sitio en el móvil: servidor en la LAN y túnel HTTPS, con sus dos enlaces

Cada ficha es la transcripción del canon (npm run skills:publish, en el repo), así que su fila Fuente apunta siempre al fichero real de la skill: ~/.hermes/skills/markeup/<skill>/SKILL.md, una carpeta por skill. La única que no entra en ningún atajo es markeup-devtunnel: va suelta y su paso a paso está en §12. El detalle técnico completo —el canon, los tres atajos y las dos proyecciones— está en docs/skills-system.md.

Palabra	Qué es
Skill	Una habilidad con una sola responsabilidad. Hermes elige la que toca; tú no las llamas a mano
Canon	Los ficheros que describen las skills (`~/.hermes/skills/`). Es la fuente de verdad
Gate	El control automático que corre antes de publicar. En rojo, no hay publicación
Bloquea / avisa	Un bloquea impide publicar (un campo duro ausente, un corchete roto). Un aviso se anota y se corrige cuando toca
Frontmatter	La ficha técnica de la nota, arriba del todo y entre `---`: título, slug, categoría, imagen…
Concept	La etiqueta corta de la nota (1-4 palabras). Se pinta en la tarjeta y en el grafo; el `title` es el nombre largo
Slug	El nombre de la nota en la URL: `mi-post`, en minúsculas y sin tildes
Wikilink	Un enlace interno escrito `[[slug\|texto]]`. Sin alias se pinta con la etiqueta de la nota destino
Huérfano	Un concepto que se enlaza desde otras notas pero todavía no tiene nota propia
Bundle (atajo)	Un `slash command` que carga varias skills de golpe: `/markeup-post`, `/markeup-publish`, `/markeup-verify`
Grafo	El mapa de notas enlazadas: 2D y 3D, del vault completo o de una sola sección
Deploy	Publicar de verdad: commit, push y despliegue en Cloudflare Pages

Si solo te llevas cinco cosas de esta guía, que sean estas:

Crea un post sobre [TEMA] en [CATEGORÍA]
Amplía / mejora la nota [NOMBRE]
Revisa el frontmatter de esta nota
Enlaza los conceptos de esta nota
¿Cómo está de salud el vault?

Con la primera creas contenido, con la segunda lo mejoras, con la tercera y la cuarta lo dejas impecable, y con la quinta mantienes el conjunto sano.

Y recuerda siempre los tres verbos: sí, modificar, cancela. Son tu control absoluto sobre lo que se escribe en el vault.

Eso es todo. Hermes valida, construye el sitio y lo despliega. Si algo falla, se detiene y te dice qué nota es la culpable en lugar de dejarte con un error opaco.

Medida de seguridad: la publicación siempre pide confirmación previa. No hay riesgo de desplegar algo a medias sin querer.

El build falla, revisa el frontmatter de los últimos posts

Skills para Hermes Agent

Skills de Hermes Agent: chuleta de objetivos y creación de posts

Skills para Hermes Agent

Posts que enlazan a este artículo