Obsidian Skills es un repositorio oficial mantenido por kepano (Steph Ango, CEO de Obsidian) con 5 Agent Skills que enseñan a Claude Code, Codex CLI, OpenCode y cualquier agente compatible a trabajar nativamente con tu vault de Obsidian: editar markdown con wikilinks, crear bases de datos .base, dibujar canvases .canvas, controlar Obsidian desde la terminal y limpiar páginas web a markdown.

Los skills siguen la Agent Skills specification, un formato abierto donde cada skill es una carpeta con un SKILL.md que el agente carga bajo demanda. Esto significa que el mismo repo funciona en Claude Code, Codex y OpenCode sin cambios.

Por qué la uso

La integré porque resuelve un problema real para quien usa Obsidian como segundo cerebro: los agentes IA por default no saben qué es un wikilink, una callout, un .base o un canvas. Sin estos skills, Claude Code te genera markdown estándar que pierde la mitad de las features del vault. Con estos skills cargados, el agente respeta la sintaxis específica de Obsidian y puede crear bases de datos navegables, canvases visuales y notas con propiedades correctas.

Requisitos

Un agente compatible con Agent Skills (Claude Code, Codex CLI, OpenCode)
Git
Vault de Obsidian (para los skills que tocan tu vault)
Para el skill defuddle: npm install -g defuddle
Para obsidian-cli: tener Obsidian abierto con el plugin CLI

Instalación

Opción 1 — Marketplace (Claude Code):

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

Opción 2 — npx skills:

npx skills add git@github.com:kepano/obsidian-skills.git

Opción 3 — Manual en Claude Code:

Clona el contenido del repo a una carpeta .claude en la raíz de tu vault de Obsidian (o la carpeta que uses con Claude Code):

git clone https://github.com/kepano/obsidian-skills.git ~/mi-vault/.claude

Opción 4 — Codex CLI:

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

Opción 5 — OpenCode:

git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

Importante: clona el repo completo (no solo la carpeta skills/) porque OpenCode busca la estructura ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md. Reinicia OpenCode después de clonar.

Los 5 skills incluidos

Skill	Descripción	Cuándo se activa
`obsidian-markdown`	Crea y edita Obsidian Flavored Markdown con wikilinks (`[[Nota]]`), embeds (`![[archivo]]`), callouts, frontmatter, propiedades, comentarios y tags	Cuando trabajas con archivos `.md` dentro de un vault o el usuario menciona wikilinks, callouts o frontmatter
`obsidian-bases`	Crea y edita archivos `.base` (las bases de datos de Obsidian) con vistas de tabla, cards, lista o mapa, filtros, fórmulas y resúmenes	Cuando se piden vistas tipo base de datos sobre tus notas, filtros por tag/folder/propiedad o fórmulas
`json-canvas`	Crea y edita archivos `.canvas` siguiendo el JSON Canvas Spec 1.0 con nodos, edges, grupos y conexiones	Para mind maps, flowcharts, diagramas visuales o cuando se mencionan canvases en Obsidian
`obsidian-cli`	Interactúa con un vault abierto vía la Obsidian CLI: leer, crear, buscar notas, manejar tasks y propiedades, además de desarrollo de plugins y temas (recargar plugin, correr JS, capturar errores, screenshots, inspeccionar DOM)	Cuando pides operaciones sobre el vault desde terminal o desarrollo de plugins/temas
`defuddle`	Extrae markdown limpio de páginas web usando Defuddle CLI, removiendo navegación, ads y clutter para ahorrar tokens	Como reemplazo de `WebFetch` cuando das una URL para leer o analizar (no usa para `.md`, ahí WebFetch directo)

Cómo usarlo — flujos comunes

Crear una nota nueva en tu vault:

Tú: Crea una nota sobre la reunión de hoy con TechCorp, enlazada
    a la nota del proyecto y con tag #cliente.

Claude Code (con obsidian-markdown):
- Genera frontmatter con title, date, tags
- Usa [[TechCorp]] como wikilink al proyecto
- Aplica callout > [!note] para la decisión clave
- Respeta el formato de propiedades de Obsidian

Crear una vista de base de datos:

Tú: Quiero ver todos mis proyectos activos como tabla con
    cliente, deadline y estado.

Claude Code (con obsidian-bases):
- Crea proyectos.base con filtro tag = #proyecto y estado != cerrado
- Define vista de tabla con columnas cliente, deadline, estado
- Agrega fórmula para días restantes

Diagramar visualmente:

Tú: Dibújame un canvas con el flujo de mi pipeline de ventas.

Claude Code (con json-canvas):
- Crea pipeline.canvas con nodos para cada etapa
- Conecta con edges direccionales
- Agrupa etapas relacionadas

Operar el vault desde Claude Code:

Tú: Busca todas las notas con tag #idea creadas este mes y
    movélas a la carpeta Ideas.

Claude Code (con obsidian-cli):
- Corre obsidian search por tag y rango de fecha
- Mueve archivos con obsidian move
- Confirma el conteo final

Limpiar contenido web:

Tú: Lee este artículo y guárdalo como nota: https://example.com/post

Claude Code (con defuddle):
- Corre defuddle parse <url> --md
- Recibe markdown limpio (sin ads, sin nav)
- Lo guarda como nota con frontmatter source

Para qué sirve cada skill — detalle técnico

obsidian-markdown

Extiende CommonMark + GFM con:

Wikilinks: [[Nota]], [[Nota|alias]], [[Nota#heading]]
Embeds: ![[archivo]], ![[imagen.png]], ![[nota#sección]]
Callouts: > [!note], > [!warning], > [!tip] con título opcional y plegado
Frontmatter: propiedades tipadas (text, number, date, list, checkbox)
Tags inline: #tag/anidado
Comentarios: %% solo visibles en edit mode %%

obsidian-bases

Archivos YAML que generan vistas dinámicas:

Filtros: por tag, folder, propiedad, fecha
Fórmulas: propiedades computadas
Vistas: table, cards, list, map con orden de propiedades configurable
Validación: chequea YAML válido y referencias a formula.X definidas

json-canvas

Spec abierto JSON Canvas 1.0:

Nodos: text, file, link, group con coordenadas y tamaño
Edges: conexiones direccionales con color y label
Grupos: agrupación visual de nodos
Compatible: con cualquier herramienta que implemente la spec, no solo Obsidian

obsidian-cli

Comandos para Obsidian abierto:

Notas: read, create, search, list, move, delete
Tasks: crear, completar, listar
Propiedades: get, set, list por nota
Dev: reload plugin, eval JS en runtime, capture errors, screenshot, inspect DOM

defuddle

Reemplazo limpio de WebFetch:

Input: URL pública
Output: markdown limpio sin nav, ads, sidebars
Flags: --md (default), --json, -p <prop> para metadata específica
Beneficio: ahorra tokens vs HTML crudo

Por qué importa que sea oficial de Obsidian

Kepano (Steph Ango) es CEO de Obsidian y mantiene el repo directamente. Esto significa:

Los skills se actualizan cuando Obsidian saca features nuevos (Bases, Canvas, CLI son todos relativamente nuevos)
La sintaxis está validada contra el parser real de Obsidian
No es un proyecto fan, es la implementación oficial de Obsidian Inc. para agentes IA

Compatibilidad cross-agente

El mismo repo funciona en:

Claude Code — vía marketplace, npx, o .claude/ en el vault
Codex CLI — copiando skills/ a ~/.codex/skills/
OpenCode — clonando el repo completo a ~/.opencode/skills/
Cualquier agente que implemente la Agent Skills specification

Esto evita lock-in: si cambias de agente, tus skills siguen funcionando.

Limitaciones honestas

obsidian-cli requiere que Obsidian esté abierto y el plugin CLI instalado
obsidian-bases solo funciona en versiones de Obsidian con Bases (1.7+)
defuddle necesita instalar el binario aparte (npm install -g defuddle)
No reemplaza saber Obsidian — te ayuda a moverte más rápido si ya conoces la herramienta

Para quién es

✅ Te va bien si:

Usas Obsidian como segundo cerebro o knowledge base
Trabajas con Claude Code, Codex u OpenCode regularmente
Quieres que el agente respete wikilinks, callouts y propiedades de tu vault
Te interesa crear bases de datos, canvases o automatizar tu vault

❌ No la necesitas si:

No usas Obsidian
Solo escribes markdown estándar sin features de Obsidian
No usas agentes IA con skills

Recursos

GitHub: https://github.com/kepano/obsidian-skills
Agent Skills spec: https://agentskills.io/specification
Obsidian Flavored Markdown: https://help.obsidian.md/obsidian-flavored-markdown
Obsidian Bases: https://help.obsidian.md/bases/syntax
JSON Canvas Spec: https://jsoncanvas.org/
Obsidian CLI: https://help.obsidian.md/cli
Defuddle CLI: https://github.com/kepano/defuddle-cli
Creador: @kepano — Steph Ango, CEO de Obsidian

Obsidian Skills: 5 Skills para Claude Code y Codex en tu Vault [2026].