Habilidad de obsidiana: ayuda a Claude Code a leer y escribir notas de obsidiana

Esto te ayudará si alguna vez has visto a un agente codificado por IA jugando con tu bóveda de obsidiana.

Mantengo mi segundo cerebro obsidiana en el mismo LokiLinux El sistema que uso para todo lo demás. Durante varios meses, dejé Claude Corder Trabajar con mis notas sin decirle qué hacer. obsidiana Realmente funciona.

Creará enlaces Markdown normales en lugar de enlaces wiki, ignorará los bloques de marcado y no tendrá idea de qué .base archivo es cuando encuentra uno. La nota sigue abierta obsidianapero perdieron la capacidad de obsidiana Muy útil.

entonces encontré Habilidades de obsidianaun pequeño repositorio mantenido por Esteban UngoObsidiana (conocida como Kepano en GitHub). Incluye conocimientos específicos de Obsidian en habilidades de agente. Después de agregarlo a la configuración de Claude Code de mi Vault, inmediatamente noté una diferencia.

claudio Comencé a crear enlaces wiki adecuados, respetando mi filtro Bases e incluso usando la habilidad Defuddle para extraer Markdown limpio de páginas web en lugar de volcar HTML sin formato en mis notas.

En este artículo te mostraré lo que Habilidades de obsidiana Incluyendo cómo instalar Ubuntu/Debian y RHEL/LokiLinuxy cómo verificar que su agente realmente lo esté usando y no lo deje inactivo en la carpeta.

¿Qué hace realmente la habilidad de obsidiana?

Habilidades de obsidiana No el complemento Obsidian que instaló desde el navegador de complementos sociales. En cambio, es una colección de habilidades del agente: documentación de texto sin formato que cumple con la especificación Open Agent Skills.

Estos archivos están destinados a ser leídos por el agente de codificación de IA antes de comenzar a utilizar su bóveda. Herramientas similares Claude Corder, códigoy código abierto Este formato es compatible desde el primer momento.

Actualmente, el repositorio contiene cinco habilidades, cada una de las cuales le enseña a su agente de IA una parte específica de cómo funciona Obsidian:

• Reducción del precio de la obsidiana – Explicación de Markdown estilo Obsidian, incluidos enlaces wiki, incrustaciones, anotaciones y atributos YAML, que se comportan de manera diferente al Markdown estándar.
• base de obsidiana – profesor .base Formato de archivo para crear vistas de notas filtradas y basadas en fórmulas.
• lienzo-json – Cubrir áreas abiertas .canvas El formato utilizado por la función Canvas de Obsidian, incluidos nodos, bordes y grupos.
• obsidiana-cli – Mostrar a los agentes cómo utilizar la CLI de Obsidian, incluidas las tareas relacionadas con el desarrollo de complementos y temas.
• engañar – Ayuda a las agencias a extraer Markdown limpio de las páginas web en lugar de pegar grandes cantidades de HTML sin formato en notas.

Sin estas habilidades, el agente de IA simplemente tratará su bóveda como una colección de archivos de solo texto. A través de ellos, comprende la sintaxis y las estructuras que respaldan la funcionalidad de enlace, consulta y lienzo de Obsidian.

notas: Las habilidades de Obsidiana no reemplazan a Obsidian ni a la CLI de Obsidian. Simplemente proporciona instrucciones para ayudar a su agente de IA a utilizar estas herramientas de forma más eficaz.

Requisitos previos

Antes de comenzar, asegúrese de tener:

• Sistema Linux con Git instalado.
• Nodo.js y Nueva gestión de proyectos. Instalado (solo es necesario si planea utilizar el instalador npx o el comando de mercado del complemento Claude Code).
• Claude Corder, códigoo código abierto Ya instalado y funcionando.
• Bóvedas de obsidiana existentes, ya que estas habilidades están diseñadas para usarse con una de ellas.

Si has usado Claude Corder Con Obsidian Vault, básicamente estás listo. este Nodo.js Los requisitos solo se aplican a uno de los métodos de instalación que se describen a continuación.

Paso 1: Confirme que Git y Node.js estén instalados

Antes de elegir un método de instalación, verifique si git y Nodo.js Instalado. Método de instalación más rápido (npx skills) Requerir Nodo.jsmientras que el método de instalación manual sólo requiere git.

git --version
node --version

Ejemplo de salida:

git version 2.43.0
v20.14.0

Si alguno de los comandos regresa comando no encontradoinstale primero los paquetes de software que faltan.

En Ubuntu/Debian

sudo apt update
sudo apt install git nodejs npm -y

En RHEL/Rocky Linux

sudo dnf install git nodejs npm -y

aquí, sudo Ejecute el comando con privilegios administrativos, que son necesarios para instalar paquetes en el sistema.

Paso 2: elija un método de instalación

obsidian-skills Se proporcionan tres métodos de instalación. Si solo usas el código Crowder, Método A Es el más rápido porque requiere la menor configuración.

Método A: instalar desde el mercado de complementos de Claude Code

Si Claude Code es su único agente de IA, esta es la opción más rápida. Ejecute estos comandos Código Claude en el interioren lugar de en una terminal Linux normal:

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

Esto es lo que hace cada comando:

• plugin marketplace add kepano/obsidian-skills Se agregó el repositorio de GitHub como fuente del complemento. Claude Corder Se puede utilizar.
• plugin install obsidian@obsidian-skills Instale el complemento Obsidian desde esta fuente del mercado.

Debido a que estos son comandos de barra diagonal de Claude Code, no verá la salida normal del terminal. En cambio, Claude Code mostrará un mensaje de confirmación en el chat una vez que se complete la instalación.

Método B: use la habilidad npx para instalar el programa

Este método se ejecuta desde una terminal Linux normal y funciona independientemente del agente de IA que utilice. No instala todo automáticamente, pero lo guía a través de la configuración interactiva.

npx skills add 

Ejemplo de salida:

Source: .git
◇  Repository cloned
◇  Found 5 skills
◇  Select skills to install (space to toggle)
◆  Which agents do you want to install to?

El instalador se detiene ante dos mensajes, y ambos requieren que ingrese:

• Seleccione habilidades para instalar:de acuerdo a espacio Teclas para seleccionar las cinco habilidades (defuddle, json-canvas, obsidian-bases, obsidian-cliy obsidian-markdown), luego presione Ingresar. Dado que estas habilidades pueden mejorar colectivamente la forma en que su agencia maneja el contenido de Obsidian, no hay razón para omitir ninguna de ellas.
• ¿Qué agentes desea instalar?: El instalador admite 73 agentes diferentes y solo aparece en la pantalla a la vez. A pesar de universal (.agents/skills) se selecciona automáticamente y es posible que el código Crowder no sea visible inicialmente. tipo claude En el campo de búsqueda, seleccione Claude Corder Presione la barra espaciadora, luego presione Ingresar continuar.

notas: El método de instalación manual del repositorio coloca la habilidad Claude Code en un .claude El directorio está en su bóveda en lugar de .agents/skills. elegir Claude Corder Durante el proceso de instalación, asegúrese explícitamente de que los archivos estén ubicados donde Claude Code espera que se encuentren.

Una vez completada la instalación, verifique que la habilidad esté instalada:

ls -la /path/to/your/obsidian-vault/.claude

Ejemplo de salida:

defuddle  json-canvas  obsidian-bases  obsidian-cli  obsidian-markdown

si .claude El directorio está vacío o no existe, verifique .agents/skills directorio porque algunas versiones del instalador colocan archivos allí.

Método C: copiar manualmente el repositorio (Claude Code, Codex u OpenCode)

Prefiero este método porque puedo ver exactamente lo que copié y dónde termina. Ya sea que estés usando Claude Corder, códigoo código abierto.

Para el código Claude

Vaya a su bóveda de obsidiana y clone el repositorio para .claude Tabla de contenido:

cd /path/to/your/obsidian-vault
git clone .git .claude

Ejemplo de salida:

Cloning into '.claude'...
remote: Enumerating objects: 210, done.
remote: Counting objects: 100% (210/210), done.
Receiving objects: 100% (210/210), 84.30 KiB | 2.11 MiB/s, done.

Estos comandos hacen lo siguiente:

• cd /path/to/your/obsidian-vault Te lleva a la Bóveda de Obsidiana. Este paso es importante porque determina .claude Se creará el directorio.
• git clone .claude Copie el repositorio directamente en una carpeta llamada .claude En lugar de crear una carpeta llamada obsidian-skills.

para códice

Clonar temporalmente el repositorio y copiar solo skills/ Directorio de ubicación de habilidades del Codex:

git clone .git /tmp/obsidian-skills
cp -r /tmp/obsidian-skills/skills/* ~/.codex/skills/

Para código abierto

Copie todo el repositorio en el directorio de habilidades de OpenCode:

git clone .git ~/.opencode/skills/obsidian-skills

Simplemente copiar el subdirectorio skills/subdirectorio romperá este diseño y OpenCode no cargará las skills correctamente. Después de la clonación, reinicie OpenCode, ya que solo descubrirá nuevas habilidades al iniciar.

Paso tres: verificar que Claude Code sea una habilidad de lectura

La instalación de estos archivos no significa automáticamente que Claude Code los esté usando. Es una buena idea verificar que la habilidad se haya cargado correctamente.

Inicie una sesión de Cloud Code desde su Obsidian Vault:

claude

Al comenzar el curso, hágale a Claude Corder una pregunta sencilla:

What Obsidian-specific skills do you have access to right now?

Si todo está configurado correctamente, Claude Code debería mencionar los nombres de estas habilidades:

• obsidian-markdown
• obsidian-bases
• json-canvas
• obsidian-cli
• defuddle

Suele incluir una breve descripción de lo que hace cada habilidad.

Si Claude Code responde como si no supiera nada sobre la sintaxis específica de Obsidian, es posible que la habilidad no se cargue. Las dos razones más comunes son:

• El nombre del directorio es incorrecto. Debe nombrarse con precisión .claude.
• Lanzaste Claude Code desde fuera de la raíz de Vault, por lo que no puede encontrar .claude carpeta.

Una vez que Claude Code reconoce estas habilidades, puede usar la sintaxis y la funcionalidad de Obsidian para trabajar con su bóveda, en lugar de tratar todo como un archivo de texto sin formato.

Paso 4: Pon tus habilidades a trabajar

La forma más fácil de ver los beneficios. obsidian-skills Simplemente déle a Claude Code una tarea que requiera conocimientos específicos de obsidiana. Estos son los tipos de tareas en las que los agentes habituales de IA conscientes de Markdown suelen realizar mal.

Por ejemplo, lo probé con el archivo básico que quería configurar para realizar un seguimiento de mi estado. Capítulos del Curso Pro Tecnint.

En el código de Claude, utilicé esta pista:

Create an Obsidian Base file that filters notes tagged #course-chapter and groups them by a "status" property with values Draft, Review, and Published.

junto con base de obsidiana La habilidad se carga y Cloud Code genera un formulario válido. . de acuerdo a Utilice los filtros y la estructura de agrupación correctos en su primer intento.

Sin esta habilidad, a menudo adivinará la sintaxis y producirá algo que parece razonable pero que en realidad no funciona con la función Bases de Obsidian.

pista: Si guarda con frecuencia contenido web en una bóveda, intente defuddle Lo mismo ocurre con las habilidades. Pregúntale a Claude Código: Pull the clean content from this URL into a new note. Luego, los resultados se comparan con un copiar y pegar normal de la misma página. A menudo notarás que los anuncios, los menús de navegación y otros elementos innecesarios de la página se eliminan automáticamente, lo que reduce el desorden.

Mantén actualizadas las habilidades de obsidiana

obsidian-skills Mantenido activamente, con nuevas habilidades y correcciones agregadas regularmente. Si lo instaló copiando manualmente el repositorio, actualícelo como cualquier otro repositorio de Git:

cd ~/vault-path/.claude
git pull origin main

Esto entrará en tu .claude directorio y extraer los últimos cambios de él main rama.

Si instalaste Habilidades de obsidiana Con el mercado de complementos de Claude Code, no es necesario ejecutar git pull. En este caso, las actualizaciones se manejan a través del propio mecanismo de actualización de complementos de Claude Code, ya que Claude Code administra los archivos por usted.

en conclusión

en este punto, Habilidades de obsidiana Brinda a sus agentes de IA el conocimiento que necesitan para comprender cómo funciona Obsidian Vault, en lugar de tratarlo como una colección de archivos de texto sin formato. Esto puede parecer una pequeña mejora, pero marca una diferencia notable en el uso diario.

Los enlaces wiki correctamente analizados, los archivos Base aceptados correctamente por Obsidian o los archivos Canvas con nodos y bordes correctamente estructurados dependen de que el agente comprenda el formato de Obsidian desde el principio. Esto significa menos tiempo corrigiendo errores y más tiempo trabajando en notas.

Pruebe el truco de desenfoque la próxima vez que guarde un artículo en la bóveda y compárelo con su flujo de trabajo habitual de copiar y pegar. Probablemente notarás la diferencia de inmediato, ya que las notas resultantes son más limpias y contienen menos desorden.

Si ha ido un paso más allá y ha creado habilidades personalizadas para su flujo de trabajo, como la compatibilidad con complementos de Obsidian específicos o formatos de archivo personalizados, realmente me gustaría saber cómo lo hace.

Si este artículo fue útil, Compártelo Con alguien de tu equipo.