Habilidad Wiki
Esta habilidad convierte al agente en un mantenedor disciplinado de la base de conocimiento personal del usuario en <VAULT_ROOT> (la raíz del repositorio).
Paso 0 — Lee siempre AGENTS.md primero
Antes de hacer nada, lee AGENTS.md en la raíz del vault. Define el diseño de directorios, las convenciones de página, el esquema de metadatos, el formato de registro y los flujos de trabajo detallados. Este SKILL.md es solo un despachador; AGENTS.md es la fuente de verdad.
Despacho: ¿qué está pidiendo el usuario?
Selecciona exactamente una de estas intenciones del mensaje del usuario:
| Intención del usuario | Flujo de trabajo |
|---|---|
| Hace una pregunta, quiere análisis/síntesis | Consulta (abajo) |
| Dejó caer un archivo nuevo o dijo "ingiere esto" | Ingesta (ver AGENTS.md §4.1) |
| Dijo "lint" / "chequeo de salud" / "encuentra problemas" | Lint (abajo) |
| Quiere una comparación / presentación / gráfico / informe | Generar artefacto (abajo) |
| Solo está explorando o no está seguro | Ejecuta wiki stats y luego pregunta qué quiere |
Si no está claro, haz una pregunta breve de aclaración antes de proceder.
Flujo de trabajo de consulta
-
Ejecuta
wiki search <palabra clave>en la raíz del repositorio para encontrar páginas candidatas. Usa múltiples variaciones de palabras clave si es necesario. -
Lee
wiki/index.mdpara ver el catálogo. -
Lee las páginas candidatas encontradas en el paso 1.
-
Si aún falta contexto, recurre a leer los archivos relevantes en
raw/oclippings/. -
Sintetiza una respuesta con citas
[[wikilink]]a páginas de la wiki y citas[artículo](../raw/xxx.md)a fuentes originales. -
Si la respuesta tiene valor duradero (una comparación, una idea derivada, una síntesis no trivial), escríbela como un archivo markdown en
output/<YYYY-MM-DD>-<slug-corto>.mdcon metadatos:--- type: artifact kind: answer | comparison | analysis | report | slides created: <fecha> question: "<la pregunta del usuario, textual>" sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...] ---Luego pregunta al usuario: "¿Quieres archivar esta salida como
wiki/questions/<slug>.md?" (Si sí, copia y actualiza index.md y log.md). -
Si la respuesta es trivial (una consulta de hecho), solo responde en el chat — no se necesita archivo.
Flujo de trabajo de lint
- Ejecuta
wiki lint— esto escribelint/<hoy>.mdautomáticamente. - Lee ese archivo y resume para el usuario (qué problemas son reales, cuáles son falsos positivos como
[[ejemplos]]literales en la documentación). - Propón un plan de corrección priorizado. No corrijas automáticamente — deja que el usuario elija.
Flujo de trabajo de generación de artefactos
Igual que la consulta, pero la forma de entrega es explícita (tabla / diapositivas Marp / gráfico Python / canvas). Siempre guarda en output/. Para presentaciones, usa formato markdown Marp. Para gráficos, escribe un script Python en output/scripts/ y ejecútalo para producir la imagen adjunta.
Convención del directorio de salida
output/
├── 2026-06-26-rag-vs-llm-wiki.md # artefacto de respuesta/comparación
├── 2026-06-26-resumen-karpathy.slides.md # presentación Marp
├── scripts/ # scripts auxiliares para generar gráficos
└── assets/ # imágenes renderizadas, exportaciones
El directorio output/ es propiedad del LLM, solo añadir (no elimines artefactos anteriores sin preguntar). Cada archivo debe tener los metadatos mostrados arriba para que el usuario pueda promover artefactos a la wiki más adelante.
Comandos CLI disponibles (ejecuta desde <VAULT_ROOT>)
Solo cuatro comandos, deliberadamente mínimos:
wiki stats # resumen: conteo de páginas por tipo/estado
wiki log -n 10 # últimas N entradas de wiki/log.md
wiki search <regex> # búsqueda de texto completo (--scope wiki|raw|clippings|all)
wiki lint # escribe lint/<hoy>.md con huérfanos/rotos/stubs
Todo lo demás (crear páginas, editar metadatos, actualizar index.md, añadir a log.md) se hace leyendo y escribiendo directamente archivos markdown. No pidas un CLI para hacer ediciones de archivos — ese es tu trabajo.
Reglas críticas (de AGENTS.md)
- Nunca modifiques archivos en
raw/oclippings/. - Cada ingesta debe actualizar
wiki/index.mdy anteponer una entrada enwiki/log.mdcon formato## [YYYY-MM-DD] ingest | <título>. - Referencia cruzada con
[[doble-corchete]]entre páginas de la wiki. - Las páginas necesitan metadatos YAML (
type,tags,created,updated,sources,status). - Cuando tengas dudas, pregunta al usuario. No hagas grandes refactorizaciones en silencio.
Estilo de informe
Después de completar un flujo de trabajo, dale al usuario un breve resumen:
- Lo que hiciste (1–3 viñetas)
- Qué artefactos se crearon o modificaron (rutas relativas)
- Cualquier pregunta sin resolver o nuevas brechas que hayas notado
Mantenlo conciso. El usuario está navegando Obsidian en paralelo y puede ver los cambios de archivos.