Este capítulo inicia la quinta parte: Colaboración con IA.
Las cuatro partes anteriores cubrieron Obsidian en sí: cómo empezar, configurar, escribir y publicar. Esta parte cubre el otro lado: con herramientas de IA como Claude Code y Codex que pueden leer y escribir archivos locales directamente, tu bóveda de Obsidian ya no es solo un cuaderno para que tú leas; también se convierte en un banco de trabajo donde la IA puede trabajar directamente.
Este capítulo primero explica cómo empezar, con tres métodos en orden creciente de dificultad y automatización:
- La forma más simple: darle directamente la ruta del archivo a la IA, que lea y procese el archivo original
- Obsidian CLI: más eficiente que leer archivos directamente, adecuado cuando tu bóveda tiene muchos archivos
- Skill: solidificar todo el flujo de trabajo en un solo comando, completamente automatizado
Darle Directamente la Ruta del Archivo a la IA
Este es el método más simple: no se necesitan plugins, ni conocimientos de CLI.
La IA aquí se refiere a herramientas como Claude Code o Codex que pueden leer y escribir archivos locales directamente, no a interfaces de chat web como DeepSeek o ChatGPT.
Solo necesitas darle a Claude Code o Codex la ruta completa de un archivo, y puede leer el archivo y procesarlo directamente sobre el original. Por ejemplo:
- “Resume los puntos clave de esta nota:
/Users/tunombredeusuario/Documents/Obsidian/01Notes/alguna-nota.md” - “Traduce este artículo al inglés y sobrescribe el original”
- “Revisa este borrador en busca de errores tipográficos y problemas de lógica, luego corrígelos”
La IA lee el contenido del archivo, entiende tu solicitud y escribe el contenido modificado de vuelta. Resumir, traducir, pulir, ajustar el formato: estas tareas puntuales se adaptan bien a este método.
La barrera es extremadamente baja; puedes usarlo de inmediato. El único inconveniente es que tienes que especificar la solicitud y la ruta manualmente cada vez, por lo que es adecuado para un uso ocasional.
Obsidian CLI
Dar rutas de archivo directamente funciona, pero una vez que tu bóveda tiene muchos archivos, la IA escaneando archivos a ciegas se vuelve lenta y los resultados pueden no ser precisos. Ahí es donde entra la CLI.
Después de actualizar a la última versión de Obsidian, hay una interfaz CLI disponible, que permite a la IA operar directamente en tu bóveda mediante comandos.
Algunos preguntarán: ¿Acaso la IA ya no puede leer mis archivos directamente? ¿Por qué necesitamos CLI?
Aquí una analogía. Tu bóveda de Obsidian es una biblioteca con cientos de libros.
Sin CLI: Cuando la IA necesita encontrar información, solo puede buscar entre los estantes, hojeando libros uno por uno, o depender de que tú le digas “ve a la tercera fila, segundo libro”.
Con CLI: La biblioteca obtiene un sistema de recuperación. La IA ingresa un tema, y el sistema le dice directamente qué archivos son relevantes, dónde están, qué palabras clave tienen las notas—y también puede crear nuevos archivos, actualizar propiedades y mover contenido entre carpetas.
La diferencia en eficiencia es enorme. Una vez que tu bóveda tiene muchos archivos, la precisión y velocidad con la que la IA encuentra cosas están en niveles completamente diferentes con o sin CLI.
Cómo Usarlo
La forma más simple: decirle directamente a la IA que use la CLI durante tu conversación.
Por ejemplo, si quieres que la IA organice tus notas, solo di: “Usa Obsidian CLI para buscar contenido sobre XXX en mi carpeta 01Notes/”, y la IA llamará al comando obsidian search para recuperarlo, en lugar de escanear archivos a ciegas. Los comandos comunes incluyen:
- Buscar contenido:
obsidian search vault="OBSIDIAN_VAULT" query="palabra clave" path="01Notes" - Leer archivo:
obsidian read vault="OBSIDIAN_VAULT" path="04Output/nombre-archivo.md" - Crear nota:
obsidian create vault="OBSIDIAN_VAULT" path="ruta-destino.md" content="..." - Listar carpeta:
obsidian files vault="OBSIDIAN_VAULT" folder="04Output"
No necesitas memorizar estos comandos; solo dile a la IA lo que quieres hacer y deja que ella elija qué comando usar.
Una forma aún más conveniente es solidificar estas operaciones en un Skill. En el Skill, predefine qué operaciones deben hacerse a través de la CLI, y la IA seguirá automáticamente las reglas del Skill sin que tengas que recordárselo cada vez. Mi Skill de escritura para la cuenta oficial de WeChat funciona así: especifica buscar materiales con obsidian search, generar artículos con obsidian create y establecer propiedades con obsidian property:set. Cada vez que la IA ejecuta este Skill, usa automáticamente la CLI para operar la bóveda sin instrucciones adicionales.
Skill: Convertir un Flujo de Trabajo en un Solo Comando
La CLI resuelve el problema de “encontrar”, pero aún tienes que expresar manualmente tus necesidades cada vez. Si tienes un flujo de trabajo fijo, puedes escribirlo como un Skill, y luego ejecutar todo el proceso con un solo comando.
Primero, déjame explicarte qué es un Skill. En pocas palabras, un Skill es un script fijo que escribes de antemano para la IA. Incluyes todas las reglas, flujos de trabajo y requisitos de formato. Luego, cada vez que emites un comando, la IA se ejecuta según este script sin necesidad de explicaciones repetidas. Si has usado Claude Code, un Skill corresponde al comando /nombre-del-skill.
Aquí hay algunos escenarios en los que uso Skills para procesar archivos de Obsidian:
Video a texto: Videos de Bilibili o locales, extraer audio, transcribir a texto, organizar en notas de Obsidian y soltar directamente en la carpeta de entrada.
Agregar enlaces bidireccionales: Después de escribir una nota nueva, hacer que la IA escanee las notas existentes y agregue [[enlaces bidireccionales]] al contenido relacionado, tejiendo la red de información.
Escribir artículos: Dado un tema, la IA busca materiales, confirma la dirección del tema, aprende mi estilo de escritura, redacta un borrador, revisa y reduce el sabor a IA, agrega imágenes y finalmente genera el artículo en la carpeta 04Output/.
Corrección y verificación de hechos: Lanzar un borrador terminado a la IA, que lo revise párrafo por párrafo en busca de errores, problemas de lógica y afirmaciones que valga la pena verificar.
Estas tareas solían hacerse manualmente, dispersas y consumían tiempo. Con Skills, un solo comando permite que la IA ejecute todo el proceso, y solo necesitas confirmar en los puntos clave.
Los conceptos solos son demasiado abstractos. Veamos un ejemplo concreto de un Skill.
Creé un Skill de escritura para cuenta oficial de WeChat para la carpeta 04Output/, que cubre el proceso completo de escritura desde la selección de temas hasta la publicación. Así es como funciona:
Paso 1: Encontrar temas. La IA puede buscar en Reddit, Hacker News y X temas recientes populares en IA, finanzas y tecnología, y listar varios temas candidatos para que elijas.
Paso 2: Buscar materiales. Después de confirmar el tema, la IA busca automáticamente información relevante de los últimos dos años, la organiza en archivos de base de conocimiento y los guarda.
Paso 3: Discutir dirección. La IA te da 3-4 ángulos de escritura y esquemas correspondientes para que elijas. Confirmas antes de continuar.
Paso 4: Aprender estilo y redactar borrador. Varios modos para elegir: leer tus propios artículos publicados para aprender tu estilo, aplicar plantillas de estilo de autores como Jiubian o Huashu, o especificar un artículo para extraer características de estilo sobre la marcha. Después de aprender el estilo, redacta el borrador.
Paso 5: Revisar. Tres pasadas: precisión del contenido, reducir el sabor a IA (reemplazar frases como “cabe destacar”, “potenciar”, “en resumen”) y pulir detalles de oraciones y párrafos.
Paso 6: Agregar imágenes y publicar. Insertar marcadores de posición de imágenes y, si es necesario, enviar directamente al borrador de la cuenta oficial de WeChat.
Durante todo el proceso, la IA usa Obsidian CLI para operar tu carpeta: buscar notas existentes como materiales, guardar resúmenes y archivos de base de conocimiento en directorios especificados, generar el artículo final en 04Output/ y establecer propiedades de frontmatter. No necesitas mover ningún archivo manualmente.
La captura de pantalla a continuación muestra cómo se ve cuando le doy un comando de escritura a la IA:
Este es solo un ejemplo para la carpeta 04Output/. Puedes crear tus propios Skills para cualquier carpeta: un Skill para organizar notas de lectura, un Skill para resumir notas de reuniones, un Skill para revisar diarios… Mientras puedas describir claramente “lo que quiero que la IA haga por mí en esta carpeta”, puedes escribirlo como un Skill.
He publicado este Skill de escritura para cuenta oficial de WeChat como código abierto. Si lo necesitas, puedes descargarlo directamente desde mi blog: https://blog.discoverlabs.ac.cn/downloads/writing-gongzhonghao-skill/
Resumen
Lo que aprendiste hoy:
- La forma más simple: darle directamente la ruta del archivo a la IA, puede leer y procesar el archivo original—resumir, traducir, modificar, todo funciona
- Obsidian CLI: Cuando tu bóveda tiene muchos archivos, la CLI le da a la IA un “sistema de recuperación de biblioteca” para encontrar información de manera más precisa y rápida
- Skill: Escribir un flujo de trabajo fijo como un script, ejecutar todo el proceso con un solo comando, adecuado para flujos de trabajo repetitivos
Puntos clave:
- Los tres métodos aumentan en dificultad y automatización; elige según tus necesidades
- La combinación de CLI + Skill es la verdadera integración profunda de IA y Obsidian
- No necesitas escribir un Skill desde cero; puedes hacer que la IA lo escriba por ti