/ Diretório / Playground / Obsidian Skills (kepano)
← Todos os servidores ↗ GitHub
● Comunidade kepano ⚡ Instantâneo

Obsidian Skills (kepano)

por kepano · kepano/obsidian-skills

Skills do kepano (líder de design do Obsidian) que ensinam aos agentes o Obsidian de verdade — Markdown, Bases, JSON Canvas, o CLI.

obsidian-skills é um bundle de skills de Steph Ango (kepano), líder de design do Obsidian. Em vez de tratar o Obsidian como 'apenas uma pasta de .md', ele ensina ao agente as convenções reais: backlinks, Properties, queries Dataview/Bases, JSON Canvas, embeds. Mais skills para usar o Obsidian CLI para operar um vault programaticamente.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

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
  1. Auditar
    Use obsidian-skills. Audite /vault — liste inconsistências em properties, links mortos, notas órfãs.✓ Copiado
    → Inventário de problemas
  2. Normalizar
    Migre tag: para properties YAML tags: de forma consistente.✓ Copiado
    → Diffs em notas afetadas
  3. 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
  1. Schema
    Examine /vault/projects. Proponha um schema de Base — properties, tipos, padrões.✓ Copiado
    → Especificação de schema
  2. 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
  1. Agrupar
    Encontre notas relacionadas a 'sistemas distribuídos'. Agrupe por sub-tópico.✓ Copiado
    → Lista de clusters
  2. 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

FerramentaEntradasQuando chamarCusto
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

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

AlternativaQuando usarTroca
claude-obsidian-skillVocê quer padrões de workflow do dia a diaMenos cobertura dos recursos mais novos de Bases / Canvas
Uso manual do ObsidianVault pequenoNã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