Claude × Obsidian (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

/wiki — consulte seu conhecimento acumulado
/save — capture o chat como nota wiki estruturada (com backlinks, frontmatter)
/autoresearch — faça pesquisa real e gere uma entrada de wiki
Padrão LLM Wiki do Karpathy — auto-organizável
Markdown puro, sem lock-in de plugins além do próprio formato do Obsidian
Gratuito (MIT)

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": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_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": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

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

Casos de uso

Usos do mundo real: Claude × Obsidian

Como capturar uma longa conversa com o Claude como uma entrada de wiki adequada

👤 Trabalhadores do conhecimento que usam Obsidian ⏱ ~5 min beginner

Quando usar: Você teve uma ótima conversa com o Claude que precisará novamente — não deixe ela morrer no histórico do chat.

Pré-requisitos

Skill instalada; caminho do vault configurado — Defina OBSIDIAN_VAULT no ambiente; instale com git clone

Fluxo

Salvar

/save a conversa que acabamos de ter sobre padrões de React Server Components. Título: 'RSC patterns'.✓ Copiado

→ Nota criada em /Wiki/RSC-patterns.md com frontmatter + backlinks
Verificar links

Mostre-me para quais notas existentes a nova entrada cria backlinks.✓ Copiado

→ Notas vinculadas com justificativa

Resultado: Wiki ganha entrada estruturada em vez de o chat ir para o lixo.

Armadilhas

/save cria notas excessivamente longas — A skill comprime para ~600 palavras por padrão; passe --full apenas quando necessário

Combine com: obsidian-mcp-tools

Perguntar à wiki antes de perguntar ao modelo

👤 Usuários de vault de longa data ⏱ ~5 min beginner

Quando usar: Você sabe que escreveu sobre isso; verifique o vault primeiro.

Fluxo

Perguntar à wiki

/wiki O que concluí sobre error boundaries com RSC no trimestre passado?✓ Copiado

→ Citação + link para a nota fonte
Refinar

Agora estenda essa conclusão com o que puder verificar online hoje e atualize a nota.✓ Copiado

→ Nota atualizada com nova seção datada

Resultado: Vault fica mais denso em vez de redundante.

Armadilhas

Wiki tem informação desatualizada que não é atualizada — A skill sinaliza como obsoleto qualquer item modificado há mais de 6 meses; revise na recuperação

Executar /autoresearch para adicionar uma entrada de wiki embasada sobre um tópico

👤 Pesquisadores e estudantes ⏱ ~30 min intermediate

Quando usar: O tópico é novo para você; quer um resumo no estilo de notas que possa expandir depois.

Fluxo

Autoresearch

/autoresearch 'Mixture of Experts em 2026 — resultados recentes de open-source'.✓ Copiado

→ Nota criada com seções, citações e links para o vault
Refinar

Aparare para focar nas implicações práticas de treinamento.✓ Copiado

→ Nota refinada

Resultado: Entrada de vault que é ponto de partida para trabalho futuro profundo.

Armadilhas

Citações podem não estar totalmente verificadas — Combine com last30days-skill ou arxiv-mcp-server para fontes embasadas

Combine com: last30days-skill

Combinações

Combine com outros MCPs para 10× de alavancagem

claude-obsidian-skill + obsidian-mcp-tools

Usar o MCP para acesso ao vault; skill para o fluxo de trabalho

Use o claude-obsidian /save com o obsidian-mcp-tools como backend.✓ Copiado

claude-obsidian-skill + last30days-skill

Tornar as fontes do /autoresearch atuais e embasadas

Quando /autoresearch rodar, busque fontes via last30days primeiro.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
/wiki	query	Ler o vault
/save	title?, scope?	Após um chat útil
/autoresearch	topic, depth?	Adicionar nova entrada embasada

Custo e limites

O que custa rodar

Cota de API: N/A
Tokens por chamada: Leve para /wiki; mais pesado para /autoresearch (5 a 20 mil)
Monetário: Gratuito
Dica: Use /wiki antes de /autoresearch — economiza tokens por não refazer trabalho anterior

Segurança

Permissões, segredos, alcance

Escopos mínimos: filesystem-read filesystem-write

Armazenamento de credenciais: Nenhum

Saída de dados: Local, exceto quando /autoresearch busca fontes

O vault pode conter PII — seja deliberado sobre o escopo do /save

Solução de problemas

Erros comuns e correções

/save cria arquivos fora do vault

Defina a variável de ambiente OBSIDIAN_VAULT ou passe --vault explicitamente

/wiki não retorna nada

Verifique se o vault tem pelo menos 1 nota correspondente; ou reconstrua o índice da skill

Backlinks não resolvem

A wiki usa o formato [[Title]]; certifique-se de que os títulos dos arquivos correspondem exatamente

Alternativas

Claude × Obsidian vs. outros

Alternativa	Quando usar	Troca
obsidian-mcp-tools (MCP)	Você quer os blocos de construção em vez de um fluxo de trabalho	O MCP é de mais baixo nível; esta skill codifica opiniões
AgriciDaniel/wp-mcp-ultimate (domínio diferente)	Você usa WordPress para conhecimento	Plataforma diferente; mesmo autor

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills