Obsidian Skills (kepano) — Casos de uso, Instalar & Demo en vivo

Name: Obsidian Skills (kepano) (Claude Skill)
Author: kepano

Por qué usarlo

Características clave

Convenciones de Markdown que siguen los usuarios reales de Obsidian
Bases (Obsidian 1.10+) — colecciones con schema definido
JSON Canvas — mapas visuales de notas
Patrones de CLI de Obsidian para operaciones en lote
Modismos de Properties/frontmatter

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-skills-kepano",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-skills-kepano": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/kepano/obsidian-skills",
          "~/.claude/skills/obsidian-kepano"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add obsidian-skills-kepano -- git clone https://github.com/kepano/obsidian-skills ~/.claude/skills/obsidian-kepano

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Obsidian Skills (kepano)

Limpiar un vault desordenado de Obsidian con properties consistentes

👤 Usuarios de Obsidian de larga data ⏱ ~60 min intermediate

Cuándo usarlo: Años de notas — tags, properties y nombres de archivos inconsistentes.

Requisitos previos

Ruta del vault de Obsidian — Apunta el skill hacia él

Flujo

Auditar

Usa obsidian-skills. Audita /vault — lista inconsistencias en properties, enlaces rotos, notas huérfanas.✓ Copiado

→ Inventario de problemas
Normalizar

Migra tag: a properties YAML tags: de forma consistente.✓ Copiado

→ Diffs en las notas afectadas
Verificar

Vuelve a auditar. Confirma que los huérfanos tienen hogar y que las properties son consistentes.✓ Copiado

→ Auditoría limpia

Resultado: Vault que busca y enlaza limpiamente.

Errores comunes

Las ediciones masivas rompen plugins — Prueba primero en una copia de seguridad; el skill lo sugiere

Combinar con: filesystem

Convertir una carpeta de notas en una Base de Obsidian

👤 Usuarios adoptando Bases para seguimiento de proyectos ⏱ ~45 min intermediate

Cuándo usarlo: Quieres una vista tipada sobre tus notas de proyecto.

Flujo

Schema

Mira /vault/projects. Propón un schema de Base — properties, tipos, valores por defecto.✓ Copiado

→ Especificación del schema
Migrar

Actualiza cada nota del proyecto para que cumpla. Rellena los valores por defecto donde falten.✓ Copiado

→ Notas conformes; la vista Base funciona

Resultado: Base funcional; puedes ordenar, filtrar y agrupar tus proyectos.

Errores comunes

Mismatches de tipo en properties — El skill valida los tipos — corrige las notas marcadas antes de que la Base se cargue limpiamente

Generar un JSON Canvas de notas relacionadas sobre un tema

👤 Investigadores / escritores ⏱ ~30 min intermediate

Cuándo usarlo: Quieres un mapa visual de cómo se conectan las notas sobre un tema.

Flujo

Agrupar

Encuentra notas relacionadas con 'distributed systems'. Agrupa por sub-tema.✓ Copiado

→ Lista de clusters
Renderizar

Renderiza como JSON Canvas con cajas agrupadas y aristas para los backlinks.✓ Copiado

→ Archivo .canvas escrito

Resultado: Un canvas que puedes abrir en Obsidian y explorar visualmente.

Errores comunes

El layout se solapa — El skill incluye un auto-layout básico; refina en Obsidian

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

obsidian-skills-kepano + filesystem

Acceso directo a archivos para editar el vault

Lee/escribe notas via filesystem; obsidian-skills gestiona las convenciones.✓ Copiado

obsidian-skills-kepano + claude-obsidian-skill

Combina con el skill Claude×Obsidian de Daniel

Usa ambos — kepano para convenciones, claude-obsidian para el flujo de trabajo diario.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
audit_vault	path	Limpieza periódica	tokens scaled to vault size
design_base	folder	Al adoptar Bases	tokens
render_canvas	note_set, layout?	Mapas visuales	tokens
obsidian_cli	command	Operaciones en lote via CLI	tokens for parsing output

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: N/A
Tokens por llamada: Alto en vaults grandes; ayuda limitar a carpetas
Monetario: Gratis
Consejo: Audita por carpeta, no el vault entero, en la primera ejecución

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Read/write to vault

Almacenamiento de credenciales: Ninguno

Salida de datos: Ninguno

Notas personales — ten cuidado con lo que pegas en el chat con agentes en la nube

Resolución de problemas

Errores comunes y soluciones

Schema de Bases rechazado

Los tipos de properties deben coincidir en todas las notas — el skill marca los infractores

Canvas se solapa

Reduce el tamaño del cluster o abre en Obsidian para limpieza manual

Comando CLI no encontrado

Instala el CLI de Obsidian por separado; el skill asume que está en el PATH

Alternativas

Obsidian Skills (kepano) vs otros

Alternativa	Cuándo usarla	Contrapartida
claude-obsidian-skill	Quieres patrones de flujo de trabajo para uso diario	Menos cobertura de las nuevas funciones Bases / Canvas
Uso manual de Obsidian	Vault pequeño	No escala a miles de notas

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills