Faz lint e organiza os vaults (links quebrados, órfãos, duplicatas, notas obsoletas, tags, MOCs) e produz um relatório. Exclusões requerem a aprovação do proprietário.
O que é kb-template?
Esta skill automatiza a manutenção de um vault de conhecimento pessoal (como um vault Obsidian, Foam ou Zettelkasten) por meio de scripts Python e diretrizes claras. Ela verifica links quebrados, encontra notas órfãs, detecta duplicatas, identifica notas desatualizadas, normaliza tags e gerencia sumários de tópicos (MOCs). O processo gera um relatório completo para o proprietário, que deve aprovar exclusões ou mesclagens que removam conteúdo. A skill foi projetada para plataformas como Claude Code, Cursor e Codex, e utiliza ferramentas como `ripgrep` (rg) para comparação de conteúdo e `git` para controle de versão. Ela é útil para manter um vault limpo, consistente e navegável, evitando perda acidental de informações.
A partir da raiz do repositório: git pull --rebase.
Execute python3 scripts/lint.py (todos os vaults) e colete a saída.
Links quebrados: corrija erros de digitação/renomeação apontando para a nota existente; se o destino estiver realmente ausente, crie um stub apenas se útil, caso contrário, remova o link. Nunca invente conteúdo.
Órfãos: vincule cada órfão a partir de uma nota relacionada ou MOC; se não couber, mova para Inbox/.
Duplicatas: encontre títulos/aliases/conteúdo semelhantes (rg, compare). Mescle na nota melhor (mantenha todos os fatos, união das fontes, adicione alias, redirecione links). Mesclagens que removam conteúdo ou arquivos: proponha, não faça.
Tags: normalize maiúsculas/kebab-case, mescle sinônimos (#ideias para #ideia), remova tags isoladas e ruidosas.
Frontmatter: garanta que created/updated/source/tags estejam presentes e válidos.
Inbox: arquive notas de Inbox/ no lugar certo quando estiver claro.
MOCs: mantenha Home.md e os MOCs de tópicos atualizados; crie um MOC quando um tópico atingir ~5 notas.
Reexecute lint; faça commit por alteração lógica (garden(<v>): ...); envie (push) logo em seguida.
Relatório para o proprietário: o que foi corrigido, além de exclusões/mesclagens/arquivamentos propostos que precisam de aprovação. Nunca exclua sem a aprovação do proprietário.
Individual skills in this repo
This repo contains 2 individual skills — each has its own dedicated page.