01 Por qué Obsidian funciona tan bien como memoria
La ventana de contexto de Claude es memoria de trabajo: se llena, se compacta y desaparece al cerrar la sesión. Lo que necesitas es un sitio estable donde queden las decisiones, los acuerdos con clientes y el estado de cada proyecto, y que Claude pueda leer al empezar. Obsidian encaja porque no guarda nada en un formato propio: cada nota es un archivo .md en una carpeta de tu ordenador. Claude Code ya sabe leer y escribir esos archivos sin conversiones.
La gracia está en tres detalles: las notas se enlazan con [], así que Claude puede seguir el hilo de un concepto a otro; puedes abrir el vault con cualquier editor o versionarlo con Git; y no dependes de una nube concreta. Si mañana dejas Obsidian, tus notas siguen ahí.
Sin vault
Repites el contexto en cada sesión, gastas tokens explicando lo mismo y las decisiones se pierden entre conversaciones.
Con vault
Claude lee un archivo de estado al arrancar, consulta solo las notas que necesita y guarda lo nuevo al terminar.
Con obsidian-skills
Además escribe con la sintaxis exacta de Obsidian: propiedades, callouts, embeds, bases de datos y lienzos.
02 Qué añaden las obsidian-skills
Son un conjunto de skills publicadas por kepano (Steph Ango), de Obsidian, que siguen el estándar abierto de Agent Skills. Funcionan en Claude Code y también en otros agentes compatibles. Claude las activa solo cuando la tarea lo pide, así que no cargan contexto de más.
| Skill | Para qué la usa Claude |
|---|---|
| obsidian-markdown | Escribir notas con wikilinks, embeds, callouts y propiedades en el formato propio de Obsidian. |
| obsidian-bases | Crear y editar archivos .base: vistas tipo base de datos con filtros, fórmulas y resúmenes. |
| json-canvas | Generar lienzos .canvas con nodos, conexiones y grupos, útiles para mapas mentales o flujos. |
| obsidian-cli | Interactuar con el vault mediante la CLI de Obsidian, incluido el desarrollo de plugins y temas. |
| defuddle | Extraer el contenido limpio de una página web en Markdown, sin menús ni publicidad, para ahorrar tokens. |
| knap | Rellenar plantillas Markdown a partir de datos JSON o CSV y generar muchos archivos de golpe. |
03 Instalación paso a paso
-
1
Instala Obsidian y crea un vault
Descárgalo desde su web oficial. Al abrirlo, elige crear un vault nuevo: es solo una carpeta, por ejemplo Documentos/Cerebro.
-
2
Abre una terminal en esa carpeta
Claude Code solo ve los archivos de la carpeta desde la que lo arrancas, así que entra siempre en el vault antes de lanzarlo.
-
3
Instala las skills desde el marketplace de plugins
Dentro de Claude Code, añade el marketplace del repositorio e instala el plugin. Es la opción más cómoda para recibir actualizaciones.
-
4
Alternativa sin plugins
Puedes usar el instalador de skills por npx o copiar a mano el contenido del repositorio en una carpeta .claude en la raíz del vault.
-
5
Comprueba que funcionan
Pide a Claude que cree una nota de prueba con propiedades y un callout. Ábrela en Obsidian: debe verse con formato, no como texto plano.
cd ~/Documents/Cerebro
claude/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skillsnpx skills add https://github.com/kepano/obsidian-skills04 El CLAUDE.md del vault: el paso que más se nota
Las skills enseñan a Claude a escribir en Obsidian, pero no le dicen cómo está organizado tu vault ni cuándo debe guardar algo. Para eso está el archivo CLAUDE.md en la raíz: Claude Code lo lee automáticamente al iniciar cada sesión en esa carpeta. Mantenlo corto y concreto; cada línea se carga siempre.
# Vault de trabajo
Este vault es la memoria compartida entre sesiones. Lee antes de escribir.
## Al empezar
- Lee `00-estado.md` y la nota del proyecto que te indique.
- No abras carpetas enteras: busca por nombre o por enlace.
## Estructura
- `clientes/` una nota por cliente (contacto, acuerdos, tono)
- `proyectos/` una carpeta por proyecto con `estado.md`
- `ideas/` notas sueltas, una idea por archivo
- `registro/` una nota por día con lo hecho y lo pendiente
## Al escribir
- Nombres de archivo en minúsculas con guiones.
- Propiedades: tipo, cliente, fecha, estado.
- Enlaza cada nota nueva con al menos una existente.
- Antes de crear, comprueba si ya hay una nota parecida.
## Al terminar
- Actualiza `estado.md` del proyecto y añade el día a `registro/`.
- Nunca guardes contraseñas, claves ni datos personales de terceros.05 La rutina diaria con prompts listos
Vamos a seguir con el proyecto [nombre]. Lee su estado.md y las dos últimas notas de registro/ que lo mencionen. Resúmeme en cinco líneas qué está hecho, qué falta y qué decisiones siguen abiertas. No leas nada más hasta que te lo pida.Antes de terminar: crea la nota de hoy en registro/ con lo que hemos hecho, las decisiones y su motivo, y los pendientes con responsable. Actualiza estado.md del proyecto. Enlaza ambas notas con la del cliente. Enséñame el diff antes de guardar.Extrae el contenido limpio de esta URL: [url]. Crea una nota en ideas/ con un resumen de diez líneas en español, tres aplicaciones prácticas para nuestros clientes y la fuente en las propiedades. Enlázala con las notas que traten el mismo tema.Crea una base en proyectos/panel.base que liste todas las notas estado.md con su cliente, estado y fecha de última actualización, ordenadas por fecha. Añade una vista filtrada solo con los proyectos bloqueados.06 Buenas prácticas y seguridad
- ✓Una nota de estado por proyecto: es lo primero que Claude debe leer y lo último que actualiza.
- ✓Notas cortas y atómicas: Claude encuentra y enlaza mejor diez notas pequeñas que un documento enorme.
- ✓Versiona el vault con Git o haz copias periódicas para poder deshacer cambios masivos.
- ✓Pide siempre el diff cuando Claude vaya a modificar muchas notas a la vez.
- ✓Mantén el CLAUDE.md por debajo de una página y revísalo cada pocas semanas.
- ✓Separa vaults: uno personal y otro de trabajo, para que el contexto no se mezcle.
07 Errores típicos y cómo resolverlos
| Síntoma | Causa probable | Solución |
|---|---|---|
| Claude no ve tus notas | Lo arrancaste desde otra carpeta | Sal, entra en el vault con cd y vuelve a lanzar claude. |
| Las notas salen como texto plano | Las skills no están instaladas o activas | Revisa /plugin y reinstala; abre una sesión nueva. |
| Notas duplicadas | El CLAUDE.md no obliga a buscar antes de crear | Añade la regla de comprobar si existe una nota parecida. |
| Se gasta mucho contexto al empezar | Claude lee carpetas enteras | Limita la lectura inicial al archivo de estado y al proyecto concreto. |
Preguntas frecuentes
No. Las obsidian-skills se instalan en Claude Code, no en Obsidian. Obsidian solo sirve para leer y organizar las notas que Claude crea.
Esta guía usa Claude Code, que lee el CLAUDE.md y las skills del proyecto. Las skills siguen un estándar abierto, así que también pueden añadirse a otros agentes compatibles.
Las obsidian-skills enseñan el formato de Obsidian y dejan la organización en tus manos. claude-obsidian añade un flujo completo de ingesta de fuentes y wiki gestionada. Puedes empezar con estas y pasar al otro si necesitas más automatización.
Los archivos siguen en tu disco. Solo las partes que Claude lee viajan al modelo como contexto de la conversación, igual que cualquier archivo que abras con Claude Code.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.