Contexto del vault: la skill markeup-context de MarkeUP

La skill markeup-context —«Rutas, reglas y protocolo de entrada del vault MarkeUP»— es una de las habilidades que el sistema MarkeUP tiene escritas para Hermes Agent y para Cline. Esta página es su ficha pública: lo que sabe hacer, cuándo se usa y qué comandos ejecuta.

Antes de escribir una línea, esta skill fija el terreno: dónde vive cada cosa y qué reglas no se negocian.

El texto de la sección «Instrucciones del canon» está transcrito del fichero fuente —que se escribe sin tildes por convención de su propio gate—, así que es exactamente lo que lee el agente cuando le pides algo. La cabecera y esta entradilla sí están redactadas para leerlas.

Dato	Valor
Skill	`markeup-context`
Responsabilidad	Rutas, reglas y protocolo de entrada del vault MarkeUP.
Versión	1.3.0
Autoría	uriszarernesto-blip · licencia MIT
Plataformas	linux · macos
Tags del canon	markeup · vault · context · bootstrap · obsidian · astro
Skills relacionadas	markeup-frontmatter · markeup-content · markeup-wikilinks · markeup-seo · markeup-audit · markeup-cli
Fuente	`~/.hermes/skills/markeup/markeup-context/SKILL.md`

Atomo raiz. Toda tarea del vault MarkeUP debe cargar este contexto primero. No genera contenido: resuelve rutas, carga las reglas canonicas y fija el protocolo del punto de entrada.

Al inicio de cualquier flujo del vault (crear post, auditar, enriquecer wikilinks, publicar).
Cuando dudes de una ruta, una regla o el formato de respuesta esperado.
No lo uses para redactar contenido: eso es markeup-content.

Lee references/vault-paths.md (esta carpeta). Es la unica fuente de verdad de rutas. Regla dura: nunca escribas rutas absolutas con $VARIABLES sin expandir, ni las dupliques en otras skills; todas apuntan a ese archivo.

Resumen (detalle y verificacion en el reference):

Recurso	Ruta
Raiz del proyecto	`~/markeup`
Vault de posts	`~/markeup/src/content/posts`
Reglas	`.../hermes/rules/`
Memoria (indice)	`.../hermes/memory/vault-index.md`
Plantilla canonica	`.../hermes/templates/post-template.md`
Schema Astro	`~/markeup/src/content.config.ts`

Aviso para herramientas de archivo (VS Code / Cline / Hermes): las herramientas de archivo no expanden variables de shell. $OBSIDIAN_VAULT_PATH y ~ no sirven como argumento: pasa siempre la ruta absoluta resuelta.

Lee estos cuatro archivos completos antes de actuar (rutas en references/vault-paths.md):

rules/frontmatter-spec.md - los 22 campos YAML (4 duros; el resto, recomendados que solo avisan).
rules/seo-spec.md - autoridad SEO (v1.1): title 50-75 (duro 40-90), description 140-200 (duro 100-260), palabra clave del concept al frente, fillers y ganchos prohibidos, sin canibalización. concept (etiqueta corta que se PINTA) ≠ title (SEO).
rules/style-guide.md - tono, estructura y SEO on-page.
rules/wikilinks-spec.md - Regla de Oro: [[slug|alias]], alias obligatorio en parrafos.

Complementos: memory/vault-index.md (slugs, tags y huerfanos existentes) y hermes/templates/post-template.md (plantilla con placeholders {{...}}).

Precedencia de autoridad (si algo se contradice):

wikilinks-spec.md    + scripts/mjs/validate-wikilinks.mjs    (autoridad ejecutable)
frontmatter-spec.md  + scripts/mjs/validate-frontmatter.mjs  (autoridad ejecutable)
   >   style-guide.md   >   src/content.config.ts (schema real de Astro)
      >   memory/conventions.md (registro historico, NO fiable para reglas)

memory/conventions.md es un registro acumulativo: puede contener afirmaciones obsoletas (p. ej. presenta [[slug]] sin alias como sintaxis valida, lo que contradice la Regla de Oro). Nunca lo uses como autoridad normativa.

Lee references/entry-points.md y aplica el bloque que corresponda al contexto de invocacion.

Punto de entrada	Confirmacion	Entrega	Escritura
Obsidian	Bloque plegable + wikilink de la nota	Nota completa	Edicion quirurgica
Telegram	Texto `si` / `modificar` / `cancela`	Resumen <= 3500 caracteres	Solo tras confirmar
VS Code / Cline	Diff explicito antes/despues	Fragmentos con ruta	Edicion atomica
Hermes CLI	Flag `--yes` o 1 turno	One-shot completo	Directa + log

Si el punto de entrada es ambiguo, pregunta antes de generar. Si sospechas Telegram, asume el limite de longitud y no vuelques el archivo entero en el mensaje.

Obsidian: devuelve la nota lista para pegar, con frontmatter y wikilinks con alias. Usa bloques plegables (> [!abstract]) para no romper la lectura de la nota.
Telegram: se conciso. Resumen + ruta destino. Nunca inventes la confirmacion del usuario.
VS Code / Cline: muestra el diff y usa edicion quirurgica; no reescribas el archivo entero.
Hermes CLI: modo one-shot; log de sesion al final (crea el directorio si falta).

references/vault-paths.md leido y rutas resueltas.
Los 4 archivos de reglas leidos.
Protocolo de punto de entrada identificado.
Ninguna ruta con $VARIABLE sin expandir pasada a una herramienta de archivo.

Cuando la tarea escribe en el vault, el gate que lo cubre entero es npm run verify:content (frontmatter, SEO, slugs, wikilinks, libros y medios).

references/vault-paths.md - SSOT de rutas del proyecto y del vault.
references/entry-points.md - protocolo detallado de los 4 puntos de entrada.
Skills que dependen de este atomo: markeup-frontmatter, markeup-content, markeup-wikilinks, markeup-seo, markeup-audit, markeup-cli.
Flujos (bundles) que empiezan cargando este atomo: /markeup-post, /markeup-publish.

¿Quieres saber cómo se piden estas cosas? La guía completa está en skills de Hermes Agent, con la chuleta de objetivos y los casos paso a paso.

Contexto del vault

Contexto del vault: la skill markeup-context de MarkeUP

Posts que enlazan a este artículo