El CEO de la empresa que desarrolla Obsidian ha publicado un manual de instrucciones gratuito para IA.
Puedes encontrarlo aquí:
https://github.com/kepano/obsidian-skills
Contiene solo 5 archivos de texto. Su instalación toma solo 5 minutos y no romperá tus notas existentes.
Al añadirlos, la IA entenderá el formato específico de Obsidian. Esta es la respuesta oficial al problema de «la IA me desordena las notas».
Cuando vi que esto se estaba volviendo un tema candente y abrí mi propio entorno para instalarlo, me di cuenta de que ya estaba ahí...
La fecha del archivo era el 26 de abril. Lo había instalado hacía tres meses y medio y lo había olvidado por completo (lol).
Entonces, ¿qué cambió en mi Obsidian durante esos tres meses y medio? Sentía curiosidad, pero los resultados fueron bastante decepcionantes.
Yendo directo a la conclusión: las instrucciones oficiales por sí solas no son suficientes. Hay una página más que debes escribir tú mismo.
Lo que la IA no sabe: la sintaxis específica de Obsidian
Obsidian tiene varias funciones únicas que lo diferencian de las apps de notas estándar.
Para enlazar notas, las rodeas con [[ ]]. (Enlaces)
Para hacer que una nota destaque, usas una sintaxis específica para crear una caja con color. (Callouts)
En la parte superior de un archivo hay una sección para fechas y etiquetas. (Propiedades)
La IA escribe sin conocer estas reglas. Así que, aunque el texto pueda estar bien, cuando lo abres en Obsidian, los enlaces no están conectados o las cajas no aparecen.
Los 5 archivos que enlacé al principio llenan ese vacío. Se dividen de la siguiente manera:
- obsidian-markdown (Sintaxis correcta para enlaces y cajas)
- obsidian-bases (Organizar notas como una tabla de base de datos)
- json-canvas (Crear diagramas que conectan notas con líneas)
- obsidian-cli (Buscar en toda la bóveda mediante comandos)
- defuddle (Importar páginas web como notas limpias)
Puedes obtenerlos gratis desde el enlace de arriba.
No son específicos de una sola herramienta de IA, así que funcionan igual con Claude Code o Codex.
Casi nada cambió después de 3.5 meses de tenerlos instalados
La verdad, me reí cuando los encontré. Ya tenía las famosas instrucciones... y ni siquiera me había dado cuenta (lol).
Sin embargo, como solo estaban funcionando en Claude Code, copié los mismos 5 archivos a Codex el 9 de agosto para poder usarlos desde cualquiera de los dos.
Ahora, este es el punto principal.
¿Qué cambió en mi Obsidian después de tres meses y medio?
- Notas con callouts: 32 de 1,387
- Vistas de base de datos: 1
- Canvas: 1
Casi nada cambió.
Esto no quiere decir que las instrucciones oficiales sean malas. Por supuesto, el contenido está bien hecho.
Cuando las instalé por primera vez, las probé, pensé «Oh, qué práctico», y eso fue todo. Como no había decidido cuándo usarlas, este fue el resultado natural.
La razón por la que nada cambió es clara: las instrucciones oficiales enseñan el «cómo escribir».
Saber escribir no aumenta el contenido que escribes. Tampoco decide dónde poner las cosas.
Hay dos tipos de instrucciones para darle a la IA
Creo que esto es muy importante.
Hay dos tipos de manuales de instrucciones para darle a una IA.
- La sintaxis correcta de Obsidian. Esta es la misma para el Obsidian de todos, así que el equipo oficial la proporciona.
- Tus propias reglas internas. Dónde poner cada cosa. Qué áreas se pueden tocar. Dónde debe ir el producto final.
El equipo oficial solo proporciona la primera.
Y la causa de una bóveda desordenada suele ser la segunda. Es más problemático tener algo escrito correctamente pero ubicado en el lugar equivocado que tener un error de sintaxis.
Aquí es donde te metes en problemas sin «reglas internas»:
- Los artículos terminados se guardan en una carpeta diferente cada vez.
- La IA añade texto a un diario que querías mantener como solo lectura.
- Aunque cambiaste el nombre de una carpeta, las notas nuevas siguen apareciendo con el nombre antiguo.
En todos estos casos, la sintaxis es perfecta. Solo la ubicación y el manejo están mal.
Por ejemplo, las instrucciones oficiales dicen: «Conecta las notas relacionadas con enlaces». Eso es correcto.
Pero mi regla es la contraria: solo enlazo las notas que «definitivamente abriré más tarde». Si aumento demasiado los enlaces, no puedo encontrar nada.
No se trata de cuál es la correcta; es solo que la guía oficial no puede contemplar mis circunstancias específicas.
Por mucho que uses la IA, tus activos no aumentarán por sí solos. Ya tienes los materiales; solo te falta el «contenedor».
Las instrucciones oficiales te enseñan la «forma» del contenedor, pero tú tienes que decidir qué poner y dónde.
━━━━━━━━━━━━
Para quienes usan IA pero sienten que crear contenido no se está volviendo más fácil:
Deja de empezar desde cero cada vez guardando tus materiales en un solo lugar.
He iniciado la «Bitácora de implementación de Obsidian x Agente IA de Minami».
Léela gratis aquí ↓
https://lifebaselab-m.com/p/r/j8MTvDdP?free1=x
━━━━━━━━━━━━
Los 4 elementos mínimos necesarios para tus reglas internas
Creé un solo archivo en Obsidian llamado «Reglas de Operación» y escribí todo allí. Tanto Claude como Codex lo leen antes de empezar a trabajar.
Estos son los 4 elementos que, como mínimo, harán que todo funcione:
- Áreas editables vs. áreas de solo lectura. En mi caso, los diarios, los recortes web y las notas sin clasificar son de solo lectura. Esta es la parte más importante.
- Destino para el trabajo terminado. Fija las ubicaciones: los posts para X van aquí, los artículos para Note van allá. Esto evita que la IA pregunte cada vez.
- Ruta de escape para cuando no estés decidido. Si dudas por 3 segundos, ponlo en «Sin clasificar». Esto evita quedarte atascado en la clasificación.
- Decide un solo lugar para fijar las reglas. No escribas reglas operativas en notas al azar. Fija el archivo maestro.
Especialmente el cuarto. Sin esto, las reglas se dispersan por todas partes y pierdes el rastro de cuál es la versión más reciente.
Hago revisiones semanales para que no se quede solo en la instalación
Entre los 5 archivos mencionados antes está obsidian-cli, que te permite inspeccionar toda la bóveda con comandos. Encuentra notas huérfanas, el recuento de uso de etiquetas y enlaces rotos.
Es útil, pero no funciona a menos que lo ejecutes.
Así que configuré esta «inspección» para que se ejecute automáticamente como revisión semanal. Se ejecuta sola cada domingo por la mañana y produce un informe de posibles enlaces rotos y notas desatendidas.
El mayor beneficio es no tener que acordarte de hacerlo.
Tenerlo instalado y tenerlo en funcionamiento son dos cosas diferentes.
Lo digo como alguien que lo tuvo instalado durante tres meses y medio sin que nada cambiara, así que probablemente tengo razón (lol).
En conclusión
Instalar las instrucciones oficiales toma 5 minutos. Es gratis y no romperá tus notas. No hay ningún riesgo en hacerlo.
Pero eso solo cambia la sintaxis.
La razón por la que Obsidian se desordena cuando se lo dejas a la IA no es porque no sepas usarlo. Es simplemente que aún no tienes un solo archivo de «reglas internas» que la IA pueda leer.
Así que no sientas que tienes que memorizar todo antes de delegar. El equipo oficial proporciona la sintaxis; tú solo necesitas escribir una página.
Si lo vas a hacer hoy, empieza escribiendo una línea para separar dónde la IA puede tocar y dónde no. «La carpeta del diario es de solo lectura. No la reescribas» es suficiente.
Incluso eso reducirá significativamente la cantidad de correcciones que tendrás que hacer después de que la IA termine.
━━━━━━━━━━━━
¡Gracias por leer hasta el final!
Anuncio 📢
¡Estoy haciendo un Open Chat!
Con el objetivo de aumentar los «Obsidianos», comparto historias diarias sobre Obsidian x Agentes de IA que no publico en X.
También reparto regalos, así que si te interesa, échale un vistazo ↓
