Obsidian Skills: enseñarle a tu agente a trabajar dentro de tus notas, sin API y sin integraciones

Aquí hay una idea sencilla que mucha gente todavía no ha conectado: si tus notas son ficheros de texto en tu disco, un agente puede trabajar con ellas directamente. No hace falta una API, ni una integración, ni un conector, ni esperar a que la empresa de turno publique una función de IA. Es una carpeta con markdown dentro.

Eso es lo que explota este repositorio, que mantiene kepano, el responsable de Obsidian. Son cinco skills que le enseñan a tu agente los formatos concretos de una bóveda de Obsidian para que no destroce nada al escribir.

Y como están escritas contra la especificación abierta de Agent Skills, funcionan en Claude Code, en Codex y en OpenCode. No es un plugin de Obsidian: es conocimiento sobre Obsidian que le das al agente.

Las cinco skills

Skill	Qué le enseña al agente
obsidian-markdown	El markdown propio de Obsidian: enlaces internos, incrustaciones, avisos y propiedades
obsidian-bases	Los ficheros .base: vistas, filtros, fórmulas y resúmenes, o sea las bases de datos de la bóveda
json-canvas	Los ficheros .canvas: nodos, aristas, grupos y conexiones del lienzo visual
obsidian-cli	Manejar la bóveda desde la línea de órdenes, incluido el desarrollo de plugins y temas
defuddle	Extraer markdown limpio de una página web, quitando la morralla para gastar menos tokens

Las cuatro primeras son lo que esperarías. La quinta merece un aparte, porque defuddle es útil aunque no uses Obsidian en tu vida: coge una página web, le quita menús, banners, avisos de cookies y pies de página, y devuelve el texto limpio en markdown. Menos tokens por documento significa menos coste y menos ruido para el modelo. Es la clase de utilidad aburrida que acaba usándose todos los días.

Por qué esto funciona y con otras herramientas no

La gracia está en los formatos abiertos, y conviene entenderla porque es el argumento de fondo.

Una nota de Obsidian es un fichero .md en una carpeta tuya. Una base es un .base de texto plano. Un lienzo es un .canvas, que es JSON con una especificación pública. Todo eso un agente lo lee y lo escribe con las herramientas que ya tiene: abrir fichero, editar, guardar.

Compáralo con una herramienta cuyas notas viven en la nube de un tercero. Ahí el agente necesita una API, credenciales, permisos, límites de peticiones y que el fabricante haya decidido exponer lo que quieres hacer. Es la diferencia entre trabajar con documentos y trabajar a través de una ventanilla. Si estás valorando dónde poner tu conocimiento a largo plazo, esto pesa más que la lista de funciones: lo repaso en alternativas a Notion con IA.

Entonces, ¿para qué hacen falta las skills si el agente ya puede abrir ficheros? Para que no la líe. Sin ellas, un agente escribe markdown genérico: te pone enlaces en formato estándar en vez de enlaces internos, te rompe las propiedades del encabezado o te genera un .canvas que Obsidian no abre. Las skills son el manual de estilo de la casa.

Cómo instalarlas

Por el marketplace de plugins, que es lo más cómodo:

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

O con el instalador genérico de skills:

npx skills add https://github.com/kepano/obsidian-skills

En Codex se copia el directorio skills/ a ~/.codex/skills. En OpenCode hay un detalle que el propio repositorio subraya y que causa fallos: hay que clonar el repositorio entero en ~/.opencode/skills/, no solo la carpeta interior, porque la estructura de directorios tiene que quedar completa.

Y el uso, una vez instaladas, es hablar normal:

Repasa las notas de la carpeta clientes/, saca las tareas pendientes
que aparezcan sueltas en el texto y móntame un .base con vista de tabla
filtrada por fecha de vencimiento. Usa enlaces internos a la nota de
cada cliente, no rutas.

El aviso: lleva dos meses sin cambios

El último cambio del repositorio es del 8 de junio de 2026. No es abandono —una skill es texto y no se rompe sola—, pero conviene saberlo: si Obsidian cambia un formato, las instrucciones pueden quedarse desfasadas y el agente escribirá algo que ya no encaja.

Es un riesgo bajo y con una ventaja compensatoria: al ser ficheros de texto con licencia MIT, puedes abrir la skill y corregirla tú en dos minutos. Prueba a hacer eso con una integración cerrada.

Cuándo no te compensa

• Si no usas Obsidian, quédate solo con defuddle, que es independiente del resto.
• Si tus notas están en Notion, Evernote o similares, esto no te sirve: el planteamiento entero depende de que los ficheros sean tuyos y locales.
• Si esperabas que el agente "entienda" tus notas, ojo con las expectativas: le enseñan los formatos, no tu contexto. Que sepa escribir un .base correcto no significa que sepa qué es importante en tu trabajo.
• Si vas a dejar al agente suelto sobre una bóveda de años, haz copia antes. Escribir en tus notas es escribir en tus notas.

Para quién sí: para quien ya tiene una bóveda viva y se ha encontrado copiando y pegando entre el chat y sus notas. Ese ir y venir es exactamente lo que esto elimina. Y si quieres el formato por dentro para escribir las tuyas, la referencia está en el repositorio oficial de skills.

Preguntas frecuentes

¿Necesito un plugin de Obsidian para usar esto?

No. Las skills se instalan en el agente, no en Obsidian. El agente trabaja sobre los ficheros de la bóveda directamente.

¿Funciona con Codex y OpenCode o solo con Claude Code?

Con los tres. Siguen la especificación abierta de Agent Skills. En OpenCode hay que clonar el repositorio completo dentro de la carpeta de skills para que la estructura quede bien.

¿Puede el agente estropear mis notas?

Puede, como cualquier programa con permiso de escritura. Haz copia de seguridad antes de la primera pasada y, si tu bóveda está en un repositorio de Git, aún mejor: ves exactamente qué ha tocado.

¿Para qué sirve la skill defuddle?

Para convertir una página web en markdown limpio, sin menús ni banners. Ahorra tokens y quita ruido. Es útil aunque no uses Obsidian.

¿Es gratis?

Sí, licencia MIT. Obsidian es gratuito para uso personal y lo que pagas aquí es el consumo del agente.