Las skills de Obsidian para agentes proporcionan a un agente de programación pautas sobre los formatos y las herramientas de una bóveda de Obsidian. Steph Ango mantiene el obsidian-skills repositorio, que incluye skills para notas Markdown, Bases, JSON Canvas, Obsidian CLI y extracción web. Instala la que corresponda al trabajo que quieres encargar al agente y comprueba después los archivos resultantes en tu bóveda.

Son instrucciones para un agente. Instalar una skill no instala Obsidian, conecta una bóveda privada ni concede acceso a tus notas. Decide qué bóveda o carpeta puede utilizar el agente antes de pedirle que haga cambios.

Elige una skill según el resultado que necesites

Tarea

Skill de Thrive

Resultado o dependencia

Escribir notas enlazadas con propiedades y bloques destacados

Obsidian Markdown

.md (notas)

Organizar notas en vistas filtradas

Obsidian Bases

.base (archivos)

Disponer notas e ideas en el espacio

Obsidian JSON Canvas

.canvas (archivos)

Buscar o gestionar desde el terminal una bóveda en ejecución

Obsidian CLI

Obsidian CLI habilitada

Extraer texto legible de una página web pública

Defuddle

CLI de Defuddle instalada por separado

Empieza con Markdown si lo que buscas principalmente es mejorar tus notas. Añade Bases cuando tengas propiedades que permitan crear una vista útil. Añade Canvas cuando las relaciones o la secuencia importen más que una tabla. Instalarlo todo a la vez puede dificultar identificar qué capacidad ha producido un resultado.

Instala la skill revisada del editor

Desde el proyecto en el que trabaja tu agente, ejecuta:

npx usethrive add obsidian-markdown --agent claude
npx usethrive add obsidian-bases --agent claude

El instalador copia cada carpeta completa del editor fijada a una revisión. Para Codex, usa --agent codex; usa --agent both cuando el proyecto necesite ambas ubicaciones. Las carpetas de skills existentes se dejan intactas. Revisa una instalación anterior antes de decidir si la sustituyes.

El catálogo de Thrive enlaza al repositorio del editor. Mantén clara esa distinción: son las skills originales de Steph Ango, que Thrive incluye en su catálogo indicando su procedencia. La carpeta de la skill contiene las pautas reutilizables; tu bóveda contiene las notas que creas.

Crea una nota de la fuente antes de modificar una bóveda

Para la primera tarea, utiliza una bóveda pequeña desechable o una carpeta de muestra con copia de seguridad. Pide al agente que cree una nota nueva, muestre el resultado e identifique los enlaces que necesitan un destino existente. Evita empezar con un cambio masivo de nombres o una reescritura de todas las notas.

Nota ilustrativa de Obsidian con propiedades, wikilinks, un bloque destacado y una vista al estilo de Bases.

Disposición ilustrativa de una bóveda con propiedades de notas, wikilinks, un bloque destacado y una vista al estilo de Bases. Abre la ilustración a tamaño completo.

Esta es una nota de proyecto ficticia que puedes adaptar:

---
title: Newsletter migration
tags:
  - project
  - content
status: research
---

# Newsletter migration

## Decision to make
Choose how the archive maps into the new CMS.

## Related notes
- [[Content inventory]]
- [[Migration acceptance criteria]]

> [!warning]
> Check which source entries are drafts before importing them.

Los nombres de las propiedades son ejemplos, no un requisito para todas las bóvedas. Reutiliza el vocabulario y los tipos de propiedades que ya tienes. Si la bóveda ya usa stage en lugar de status, adapta el ejemplo a esa convención en vez de introducir un campo que compita con el existente.

Abre la nota en la vista de lectura. Comprueba que el bloque destacado se muestra, que las etiquetas tienen la forma prevista y que los nombres de las notas enlazadas son correctos. Un wikilink sin resolver puede ser intencionado si piensas crear su destino, pero no debe aparecer por accidente.

Usa Bases cuando las propiedades definan la estructura

Una Base resulta útil cuando quieres ver notas que comparten propiedades: proyectos activos, notas de lectura o registros de reuniones, por ejemplo. Antes de pedir al agente que cree la vista, enumera las propiedades existentes y los valores que contienen. Un filtro no puede distinguir de forma fiable el trabajo completado si la mitad de las notas utiliza done y la otra mitad utiliza complete sin una correspondencia definida.

Pide una vista con un propósito acotado, como notas de proyectos cuyo estado sea research. Especifica las columnas que necesitas y el comportamiento cuando falten fechas. Pruébala con una nota que cumpla el criterio, otra que no lo cumpla y otra con una propiedad ausente. Así compruebas la lógica, además del aspecto de la tabla.

Conserva las notas originales como registro de la información subyacente. Una vista bien presentada no corrige metadatos incoherentes. Si hace falta normalizarlos, propone las correspondencias y revisa una muestra pequeña antes de aplicarlas de forma generalizada.

Usa Canvas para relaciones y secuencias

La skill JSON Canvas ayuda a un agente a crear nodos y aristas en el formato .canvas de archivo. Para una migración, puedes conectar una nota de inventario con una decisión de correspondencia y después conectar esa decisión con una lista de comprobación de validación. Ese grafo explica qué evidencias llevaron a una acción.

Pide un lienzo acotado antes de añadir muchos nodos. Exige identificadores únicos, referencias válidas entre aristas y nodos, etiquetas legibles y espacio suficiente para evitar solapamientos. Valida el JSON, ábrelo después en Obsidian y revisa la disposición real. La validación de sintaxis no puede decirte si la etiqueta de un nodo es demasiado pequeña o si el diagrama está saturado.

Los nodos de archivo deben apuntar a rutas reales de la bóveda. Si el agente no conoce la ruta, pídele que enumere la referencia ausente en lugar de inventarla. Mantén las URL de fuentes externas separadas de los enlaces internos de notas para que los lectores puedan distinguir qué evidencias pertenecen a la bóveda.

Comprueba los requisitos previos de la CLI

La skill Obsidian CLI requiere la interfaz de línea de comandos de la aplicación de escritorio. La documentación de la CLI de Obsidian explica cómo instalarla y habilitarla. Consulta allí los requisitos actuales de la aplicación y el instalador, y ejecuta obsidian help para confirmar los comandos disponibles en tu equipo.

Tras la configuración, estos ejemplos orientados a la lectura pueden ayudarte a comprobar la conexión:

obsidian vault="Research" search query="migration"
obsidian vault="Research" read path="Projects/Newsletter migration.md"

Sustituye la bóveda y la ruta del ejemplo por otras que hayas autorizado al agente a leer. Seleccionar una bóveda explícitamente es útil cuando tienes varias abiertas. Escribir, renombrar y eliminar notas requiere una tarea clara y revisar las rutas afectadas; conseguir acceso mediante la CLI no concede permiso para todas las operaciones.

Mantén la trazabilidad de la investigación

Al añadir una referencia web, conserva su título, URL, fecha de consulta y los pasajes pertinentes para tu pregunta. Defuddle puede ayudar a extraer una página pública como Markdown legible, pero la herramienta debe instalarse por separado y el resultado sigue requiriendo una revisión con la fuente.

Para notas sobre vídeos, usa la skill de preparación de transcripciones de YouTube para conservar los subtítulos y las marcas de tiempo antes de crear la nota. No presentes un resumen basado únicamente en la transcripción como una revisión de las demostraciones visuales del vídeo.

Fuentes