Skill: Metadata Validator

Skill: Metadata Validator

Competencia

Especialista en validación y generación de metadatos YAML (frontmatter) para archivos .md del proyecto "Subordinación y Valor", garantizando cumplimiento de estándares y coherencia.

Cuándo se Activa

Automáticamente al:

• Crear o editar archivos .md en carpetas de contenido (0_proyecto/, 1_trasfondo/, 2_atlas/, 3_personajes/, 4_diegesis/, 5_aventuras/)
• Ejecutar comando /​check-metadata
• Ejecutar comando /​suggest-tags
• Post-edición de archivos markdown (hook)

Expertise

Esquema de Metadatos Obligatorios

Campos SIEMPRE requeridos:

---
title: Título del documento
folder: ruta/​relativa/​desde/​raiz
description: Breve descripción del contenido
---

Campos Opcionales pero Recomendados

Para todos los archivos:

tags:
  - tag1
  - tag2
  - tag3

Para cronología:

fecha: YYYY-MM-DD
region: Región, Subregión, Ciudad

Para personajes (IMPORTANTE):

facciones:
  - "Nombre Facción 1"
  - "Nombre Facción 2"
alerta-spoilers: "Texto de advertencia sobre información sensible"

Convenciones de Formato

1. Idioma: Campos en inglés, contenido en español
2. Formato de claves: kebab-case para valores (palabras-separadas-por-guiones)
3. Espaciado: SIEMPRE espacio después de dos puntos (:)
4. No tabs: Solo espacios para indentación
5. Arrays YAML: Guiones con espacios (- item)

Campos PROHIBIDOS

❌ NUNCA usar campos en español:

• titulo (usar title)
• carpeta (usar folder)
• descripcion (usar description)
• layout (no usar)
• author (no usar)

Capacidades

1. Validar Metadatos Existentes

Verificar:

• ✅ Campos obligatorios presentes (title, folder, description)
• ✅ Formato YAML correcto (sintaxis, espaciado)
• ✅ Campos en inglés
• ✅ Ruta en folder es relativa y correcta
• ✅ Tags apropiados (existen en corpus, no demasiado genéricos)
• ✅ Campos específicos por tipo (personajes: facciones obligatorio)

2. Generar Metadatos Completos

Para nuevos archivos:

1. Analizar contenido para extraer información
2. Determinar tipo de archivo (personaje/​facción/​cronología/​etc.)
3. Generar frontmatter completo con campos apropiados
4. Sugerir tags relevantes basados en contenido

3. Sugerir Tags

Buscar en corpus tags existentes que puedan aplicar:

• Tags de ubicación (darsena, tuberias, cordoba, etc.)
• Tags de personajes (nombre-apellido)
• Tags de facciones (sia, arpistas, etc.)
• Tags de conceptos (anatema-mecanico, qia, etc.)
• Tags de períodos (caos, gran-guerra, actualidad-2178, etc.)
• Tags de tipo (cronologia, relato, faccion, personaje, etc.)

4. Corregir Errores Comunes

Detectar y corregir:

• Campos en español → Convertir a inglés
• Falta de espacio después de : → Agregar espacio
• Tabulaciones → Convertir a espacios
• Tags duplicados → Eliminar duplicados
• Campo facciones faltante en personajes → Agregar (vacío o poblado)
• Ruta absoluta en folder → Convertir a relativa

Categorías de Tags

Tags de Ubicación

# Ciudades principales
darsena, cordoba, mendoza, el-paramo

# Zonas de Dársena
tuberias, barrios-del-muro, barrio-norte, microcentro
zona-centro, zona-militar, isla-oriental, fuera-del-muro

# Lugares específicos
nueva-basilica, universidad-catolica, torres-hidroponicas
crater, zona-exclusion, rio-de-la-plata

# Regiones
argentina, buenos-aires, pantano, delta

Tags de Personajes

# Formato: nombre-apellido (o apodo si es más conocido)
damian-diconte, francisco-de-la-cruz, padre-rafa
monsenor-miguel, hermana-superior-maria
paco-el-puntero, sor-sofia

Tags de Facciones

# Oficiales
sia, iglesia, iglesia-de-darsena
ejercito, armada, prefectura, fuerzas-armadas
gremio, la-union

# Proscritas/​Secretas
arpistas, guardianes, guardianes-de-la-memoria
criptografos, canales-ocultos, resistencia
umbanda, cazadores-de-pesadillas, shipibo-conibo
traficantes-de-almas

Tags de Conceptos Centrales

anatema-mecanico, corpus-licitus
qia, inteligencia-artificial
fin-de-los-secretos, gran-guerra, gran-colapso
meteorito, crater
mision-s-a-n-t-a
herejia, tecnologia-prohibida

Tags de Períodos Históricos

mundo-antiguo (2020-2029)
anos-del-caos (2029-2038)
gran-guerra (2039-2047)
fin-de-los-secretos (2048-2061)
edad-oscura (2062-2160)
confederacion-temprana (2161-2177)
actualidad-2178

Tags de Tipo de Documento

cronologia, relato, carta, cronica, diario
faccion, personaje, arquetipo
atlas, mapa, tecnologia
constitucion, herejia
guia, aventura, investigacion

Restricciones

1. Campos Obligatorios

• ❌ NUNCA omitir title, folder, description
• ✅ SIEMPRE incluir estos tres campos

2. Idioma

• ❌ NUNCA usar campos en español
• ✅ SIEMPRE inglés para campos (title, folder, description)

3. Formato YAML

• ❌ NO usar tabulaciones
• ✅ Solo espacios para indentación
• ❌ NO omitir espacio después de :
• ✅ clave: valor (espacio obligatorio)

4. Campo Facciones (Personajes)

• ❌ NUNCA omitir campo facciones en personajes
• ✅ SIEMPRE presente (puede estar vacío: facciones: [])

5. Ruta Carpeta

• ❌ NO usar rutas absolutas
• ✅ SIEMPRE relativa desde raíz del proyecto
• ✅ Ejemplos: 3_personajes/​principales, 1_trasfondo/​cronologia

Workflows

Validar Archivo Existente

1. Leer frontmatter del archivo
2. Verificar campos obligatorios
3. Validar formato YAML (sintaxis, espaciado)
4. Comprobar idioma de campos (español)
5. Verificar campos específicos según tipo:
   • Personajes: facciones presente
   • Cronología: fecha y region apropiados
6. Validar tags (existen, no redundantes, apropiados)
7. Generar reporte:
   • ✅ Correctos
   • ⚠️ Advertencias (mejoras sugeridas)
   • ❌ Errores (deben corregirse)

Generar Metadatos para Archivo Nuevo

1. Leer contenido del archivo
2. Determinar tipo (analizar ubicación y contenido):
   • 3_personajes/ → personaje
   • 1_trasfondo/​facciones/ → facción
   • 1_trasfondo/​cronologia/ → cronología
   • 2_atlas/ → ubicación/​geografía
   • 4_diegesis/ → relato/​carta/​crónica
3. Extraer información del contenido:
   • Título (primer H1 o nombre archivo)
   • Descripción (primer párrafo o resumen)
   • Tags (conceptos clave mencionados)
4. Generar frontmatter completo:

   ---
   title: [Extraído/​generado]
   folder: [Ruta relativa]
   description: [Extraída/​generada]
   tags:
     - [sugerencias basadas en contenido]
   # Campos específicos según tipo
   ---
   

Sugerir Tags

1. Leer contenido completo del archivo
2. Identificar menciones de:
   • Ubicaciones (Dársena, Córdoba, Túberías, etc.)
   • Personajes (nombres detectados)
   • Facciones (SIA, Arpistas, Iglesia, etc.)
   • Conceptos (Anatema, QIA, herejía, etc.)
   • Años/​períodos (detectar rango temporal)
3. Buscar tags EXISTENTES en corpus que coincidan
4. Ordenar por relevancia:
   • Primero: Tags existentes (para mantener consistencia)
   • Segundo: Nuevos tags sugeridos (solo si necesarios)
5. Advertir si tag parece demasiado genérico
6. Presentar lista con categorías:

   Tags sugeridos (EXISTENTES):
   - darsena
   - sia
   - damian-diconte
   
   Tags nuevos (CREAR solo si necesario):
   - [nuevo-concepto] (⚠️ Verificar si realmente necesario)
   

Ejemplos de Validación

Ejemplo 1: Frontmatter Correcto

---
title: Damián DiConte
folder: 3_personajes/​principales
description: Detective veterano de la Dirección Nacional de Seguridad, cuya investigación lo traslada de Córdoba a Dársena.
tags:
  - damian-diconte
  - detective
  - cordoba
  - darsena
  - investigacion
facciones: []
---

Validación: ✅ TODO CORRECTO

---

Ejemplo 2: Frontmatter con Errores

---
title: Damián DiConte
folder: c:\Users\gcave\Projects\Dev\syv\3_personajes\principales
description: Detective veterano...
tags:
  - Damián
  - Detective
---

Errores detectados:

• ❌ Campo title (inglés) → Usar titulo
• ❌ Campo folder (inglés) → Usar carpeta
• ❌ Ruta absoluta en folder → Usar relativa: 3_personajes/​principales
• ❌ Campo description (inglés) → Usar descripcion
• ❌ Tags con mayúsculas → Usar minúsculas kebab-case
• ❌ Campo facciones faltante (es personaje) → Agregar

Corrección:

---
title: Damián DiConte
folder: 3_personajes/​principales
description: Detective veterano...
tags:
  - damian-diconte
  - detective
facciones: []
---

---

Ejemplo 3: Personaje sin Campo Facciones

---
titulo: Dr. Francisco de la Cruz
carpeta: 3_personajes/​principales
descripcion: Decano de Historia, líder de los Guardianes de la Memoria
tags:
  - francisco-de-la-cruz
---

Error detectado:

• ❌ Campo facciones OBLIGATORIO para personajes

Corrección:

---
title: Dr. Francisco de la Cruz
folder: 3_personajes/​principales
description: Decano de Historia, líder de los Guardianes de la Memoria
tags:
  - francisco-de-la-cruz
  - guardianes
  - arpistas
facciones:
  - "Guardianes de la Memoria"
  - "Arpistas"
---

---

Notas de Uso

Prioridad de Tags Existentes

SIEMPRE preferir tags que ya existen en el corpus para mantener consistencia.

Antes de crear un tag nuevo, verificar si alguno existente puede servir:

• ¿detective en lugar de investigador?
• ¿sia en lugar de inquisicion?
• ¿darsena en lugar de ciudad-darsena?

Tags Demasiado Genéricos

Advertir si usuario intenta tags como:

• personaje (obvio en carpeta 3_personajes/)
• historia (demasiado amplio)
• importante (subjetivo)

Campo Alerta-Spoilers

Si el personaje/​facción tiene información secreta marcada como "Información secreta (no exponer a jugadores):", considerar agregar:

alerta-spoilers: "Este personaje/​facción contiene información sensible que no debe revelarse prematuramente."

Rutas Relativas Correctas

CORRECTO:

• 0_proyecto/​guias-para-colaboradores
• 1_trasfondo/​cronologia
• 3_personajes/​principales

INCORRECTO:

• c:\Users\gcave\Projects\Dev\syv\3_personajes (absoluta)
• /​3_personajes (absoluta desde raíz del sistema)
• .\3_personajes (notación relativa con punto)