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

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

Por que usar

Principais recursos

Convenções de Markdown que usuários reais do Obsidian seguem
Bases (Obsidian 1.10+) — coleções com schema definido
JSON Canvas — mapas visuais de notas
Padrões do Obsidian CLI para operações em lote
Idiomas de Property/frontmatter

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu 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
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a 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
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "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
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o 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"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Obsidian Skills (kepano)

Limpar um vault Obsidian bagunçado com properties consistentes

👤 Usuários de longa data do Obsidian ⏱ ~60 min intermediate

Quando usar: Anos de notas — tags, properties e nomenclatura de arquivos inconsistentes.

Pré-requisitos

Caminho do vault Obsidian — Aponte a skill para ele

Fluxo

Auditar

Use obsidian-skills. Audite /vault — liste inconsistências em properties, links mortos, notas órfãs.✓ Copiado

→ Inventário de problemas
Normalizar

Migre tag: para properties YAML tags: de forma consistente.✓ Copiado

→ Diffs em notas afetadas
Verificar

Re-audite. Confirme que órfãos têm destinos e que properties estão consistentes.✓ Copiado

→ Auditoria limpa

Resultado: Vault que pesquisa e vincula de forma limpa.

Armadilhas

Edições em lote quebram plugins — Teste em uma cópia de backup primeiro; a skill sugere isso

Combine com: filesystem

Converter uma pasta de notas em uma Base do Obsidian

👤 Usuários adotando Bases para rastreamento de projetos ⏱ ~45 min intermediate

Quando usar: Você quer uma visualização tipada sobre suas notas de projetos.

Fluxo

Schema

Examine /vault/projects. Proponha um schema de Base — properties, tipos, padrões.✓ Copiado

→ Especificação de schema
Migrar

Atualize cada nota de projeto para conformidade. Preencha padrões onde estiverem faltando.✓ Copiado

→ Notas em conformidade; visualização de Base funciona

Resultado: Base funcional; você pode ordenar, filtrar, agrupar seus projetos.

Armadilhas

Incompatibilidade de tipos de property — A skill valida tipos — corrija notas sinalizadas antes que a Base carregue de forma limpa

Gerar um JSON Canvas de notas relacionadas sobre um tópico

👤 Pesquisadores / escritores ⏱ ~30 min intermediate

Quando usar: Você quer um mapa visual de como as notas se conectam em um tópico.

Fluxo

Agrupar

Encontre notas relacionadas a 'sistemas distribuídos'. Agrupe por sub-tópico.✓ Copiado

→ Lista de clusters
Renderizar

Renderize como JSON Canvas com caixas agrupadas e arestas para backlinks.✓ Copiado

→ Arquivo .canvas gravado

Resultado: Um canvas que você pode abrir no Obsidian e explorar visualmente.

Armadilhas

Layout com sobreposições — A skill inclui um auto-layout básico; refine no Obsidian

Combinações

Combine com outros MCPs para 10× de alavancagem

obsidian-skills-kepano + filesystem

Acesso direto a arquivos para edições do vault

Leia/escreva notas via filesystem; obsidian-skills lida com as convenções.✓ Copiado

obsidian-skills-kepano + claude-obsidian-skill

Combine com a skill Claude×Obsidian do Daniel

Use ambos — kepano para convenções, claude-obsidian para workflow diário.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
audit_vault	path	Limpeza periódica	tokens escalados pelo tamanho do vault
design_base	folder	Adotando Bases	tokens
render_canvas	note_set, layout?	Mapas visuais	tokens
obsidian_cli	command	Operações em lote via CLI	tokens para análise do output

Custo e limites

O que custa rodar

Cota de API: N/A
Tokens por chamada: Alto em vaults grandes; restringir a pastas ajuda
Monetário: Gratuito
Dica: Audite por pasta, não o vault inteiro, na primeira execução

Segurança

Permissões, segredos, alcance

Escopos mínimos: Leitura/escrita no vault

Armazenamento de credenciais: Nenhum

Saída de dados: Nenhuma

Notas pessoais — tenha cuidado com o que cola no chat com agentes na nuvem

Solução de problemas

Erros comuns e correções

Schema de Base rejeitado

Os tipos de property devem corresponder em todas as notas — a skill sinaliza violadores

Sobreposições no canvas

Reduza o tamanho do cluster ou abra no Obsidian para limpeza manual

Comando CLI não encontrado

Instale o Obsidian CLI separadamente; a skill assume que está no PATH

Alternativas

Obsidian Skills (kepano) vs. outros

Alternativa	Quando usar	Troca
claude-obsidian-skill	Você quer padrões de workflow do dia a dia	Menos cobertura dos recursos mais novos de Bases / Canvas
Uso manual do Obsidian	Vault pequeno	Não escala para milhares de notas

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills