Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
By melgarafael
Transform any folder into a professional Obsidian vault with 100% local ML: scaffold opinionated structure, semantically cluster notes via HDBSCAN, detect duplicates and semantic gaps, generate bridge notes with a restricted LLM, validate frontmatter and normalize tags, and serve a localhost analytics dashboard with FSRS recommendations and anomaly detection. All operations run offline with human-approved batch migrations and rollback.
npx claudepluginhub melgarafael/obsidian-master-kit --plugin obsidian-master-kitAbre painel executor em localhost:4712 (Chrome/Arc/Edge/Brave)
Conduz entrevista dos 4 passos (3 Ps, precificacao, matematica, 7 acoes)
Detecta projetos ativos no PC e gera notas atomicas de contexto no vault
Scaffolda um vault Obsidian do zero seguindo o padrao obsidian-master-kit (4 areas, CLAUDE.md doutrina, _INDEX.md vivo, MOCs, templates). Conduz entrevista curta em pt-br.
Forca sincronizacao do vault Obsidian atual (invoca obsidian-librarian). Valida frontmatter, normaliza tags, atualiza _INDEX.md, detecta orfas.
Esta skill deve ser usada quando o usuario quer gerar notas-ponte no vault a partir de conteudo que JA EXISTE nele. Acionada por frases como "expande meu vault", "cria as notas que faltam entre X e Y", "preenche gaps do vault", "expande esse MOC", "ha pontes faltando aqui?", ou invoca `/obsidian-master-kit:expand`. Detecta lacunas semanticas (pares de notas proximas sem link), MOCs incompletos (MOC com poucos out-links mas cluster grande ao redor), e conceitos subjacentes ausentes (grupo de notas mencionando algo mas sem nota dedicada). Gera rascunhos `.md` marcados `status: draft, generated_by: obsidian-expand`, SEMPRE citando as notas-fonte do vault como wikilinks. NAO inventa fatos do mundo externo — se o vault nao tem informacao suficiente, a nota gerada diz isso explicitamente.
Use quando o usuario diz "meu plano de negocio", "matematica do resultado", "abre o painel do negocio", "scanear projetos", "registrar progresso", ou invoca `/obsidian-master-kit:forge-scan|plan|dash`. Conduz entrevista dos 4 passos (3 Ps, precificacao, matematica, 7 acoes macro) conforme metodologia da aula "IA como ferramenta"; mapeia projetos ativos do PC como notas atomicas; sobe dashboard HTML estatico em localhost:4712 com File System Access API para cliques executores. 100% local, zero cloud, zero daemon.
Esta skill deve ser usada quando o usuario quer iniciar um vault Obsidian do zero, criar um segundo cerebro, gerar a estrutura de pastas opinionada do obsidian-master-kit, ou quando ele invoca /obsidian-master-kit:init. Conduz uma entrevista curta em pt-br (nome, profissao, areas, projetos, fuso, tom) e scaffolda um vault completo com doutrina CLAUDE.md, _INDEX.md vivo, MOCs e templates. Idempotente: nunca sobrescreve arquivos existentes. Nao executar sem explicita intencao do usuario de criar um vault Obsidian.
Esta skill deve ser usada quando o usuario diz "sincroniza o vault", "roda o bibliotecario", "atualiza o indice do Obsidian", "valida as notas que acabei de escrever", ou invoca /obsidian-master-kit:sync. Tambem e acionada automaticamente apos qualquer Write/Edit dentro de um vault obsidian-master-kit (via hook PostToolUse). Le o CLAUDE.md do vault como memoria, valida frontmatter, normaliza tags, garante wiki-link para o MOC da area, reescreve _INDEX.md vivo e reporta desvios que exigem decisao humana. NAO deleta conteudo humano. NAO edita o CLAUDE.md do vault.
Esta skill deve ser usada quando o usuario tem um vault Obsidian ja existente e quer adotar o padrao obsidian-master-kit SEM destruir a estrutura atual. Detecta o estado do vault, faz backup automatico, roda shadow-scan com embeddings, descobre areas reais via clustering (HDBSCAN), propoe mapping pasta->area adaptativo, executa migracao em lotes com approval humano obrigatorio, e oferece rollback. Adocao hibrida (Opcao C). Invocada via /obsidian-master-kit:migrate ou quando o usuario pede "quero usar o kit no meu vault que ja existe". Nunca executa automaticamente sem aprovacao explicita.
Modifies files
Hook triggers on file write and edit operations
Share bugs, ideas, or general feedback.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Second Brain OS — 16 skills for knowledge management, deep thinking, and vault operations powered by Obsidian.
Set up or upgrade an AI-powered Obsidian vault with journaling, knowledge graphs, pattern recognition, and meeting workflows. Includes skills for daily journaling, weekly insights, graphify knowledge graphs, humanizer, and more.
Bidirectional knowledge flow between Claude Code and Obsidian — 20 MCP tools, skills, and hooks for PKM
Claude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault. Covers memory management, session notetaking, knowledge organization, and agent context across projects. Based on Andrej Karpathy's LLM Wiki pattern. Optional DragonScale Memory extension adds hierarchical log folds, deterministic page addresses, embedding-based semantic tiling lint, and boundary-first autoresearch topic selection.
Create and edit Obsidian vault files including Markdown, Bases, and Canvas. Use when working with .md, .base, or .canvas files in an Obsidian vault.
Knowledge management for Obsidian vaults and structured markdown repositories
Transforma uma pasta vazia no seu segundo cérebro em 5 minutos.
Você roda um comando, responde 7 perguntinhas, e pronto — você tem uma estrutura profissional do Obsidian com pastas, templates e um "bibliotecário" de inteligência artificial que organiza tudo pra você sozinho, pra sempre.
CLAUDE.md) que explica pra qualquer IA que for usar
seu Obsidian depois: "as regras da casa são essas aqui". Qualquer skill
respeita automaticamente.localhost:4712 onde você registra progresso com um clique e vê a agulha
se mover. Tudo local, sem nuvem.Tudo em português. Você não precisa saber nada sobre Obsidian pra começar.
Duas coisas, nada mais:
Se você já tem os dois, pula pra instalação.
A instalação é feita dentro do próprio Claude Code, usando o sistema de plugins dele. Você não precisa clonar nada no terminal, nem saber onde os arquivos vão parar — o Claude Code cuida de tudo.
Dentro do Claude Code, digite:
/plugin marketplace add melgarafael/obsidian-master-kit
O que isso faz: diz pro seu Claude Code "olha, esse repositório do GitHub tem plugins que você pode instalar". É uma só vez — depois disso, o Claude Code sabe onde achar o kit.
Ainda dentro do Claude Code:
/plugin install obsidian-master-kit@obsidian-master-kit
Pronto. O Claude Code baixa o plugin, registra as skills, commands e hook. Em alguns segundos os comandos já aparecem no autocomplete.
Digite / no Claude Code e veja se aparecem na lista:
/obsidian-master-kit:init/obsidian-master-kit:sync/obsidian-master-kit:forge-plan/obsidian-master-kit:forge-scan/obsidian-master-kit:forge-dashSe os 5 aparecerem, tá instalado. Pula pro próximo bloco.
Se não apareceram, vai pra seção Problemas comuns.
No Terminal, crie uma pasta nova (ou use uma que você já tem em mente):
mkdir -p ~/Documents/MeuSegundoCerebro
cd ~/Documents/MeuSegundoCerebro
Esse comando cria a pasta MeuSegundoCerebro dentro dos seus Documentos e
entra nela. Você pode mudar o nome se quiser.
Abra o Claude Code nessa pasta (a maioria dos sistemas deixa você clicar com botão direito na pasta e escolher "Abrir no Claude Code"). Depois digite:
/obsidian-master-kit:init
O kit vai te fazer 7 perguntinhas rápidas, todas em português:
Responde cada uma. Não tem resposta certa ou errada — é só pra IA te conhecer.
Quando as perguntas terminam, sua pasta está cheia de arquivos organizados. Abre o Obsidian, vai em File > Open Vault > Open folder as vault, aponta pra pasta que você criou no passo 1.
Boa-vinda ao seu segundo cérebro.
Seu Obsidian tem 4 grandes áreas de partida:
| Pasta | Pra que serve |
|---|---|
| 00 - Pessoal | Quem você é. Diário, reflexões, seu perfil. |
| 01 - Profissional | Seu trabalho. Projetos, áreas de responsabilidade. |
| 02 - Pesquisas e Estudos | Onde vai tudo que você (ou a IA) pesquisa e estuda. |
| 03 - Memoria da IA | Contexto pra quando você está construindo software com IA. |
E, opcionalmente, uma 5ª área criada pelo forge:
| Pasta | Pra que serve |
|---|---|
| 04 - Negocio | Plano de negócio + metas + progresso + scanner de projetos ativos. Criada quando você roda /obsidian-master-kit:forge-plan pela primeira vez. |
Dois arquivos especiais na raiz: