vault-cleanup-auditor

Visão geral da skill vault-cleanup-auditor

O que a vault-cleanup-auditor faz

A skill vault-cleanup-auditor audita um vault do Obsidian no Claude Code e gera um relatório de limpeza com data. Ela procura rascunhos desatualizados, notas incompletas, nomes de arquivos duplicados e pastas vazias, e transforma esses achados em uma revisão priorizada que você consegue agir rapidamente.

Para quem ela é

Use a skill vault-cleanup-auditor se você administra um vault pessoal ou de equipe em crescimento e precisa de uma passada de limpeza repetível, em vez de um prompt isolado. Ela é especialmente útil para quem já tem uma estrutura de vault, mas quer uma forma rápida e com pouca fricção de identificar desvios, bagunça e conteúdo que nunca foi concluído.

Por que ela é diferente

Este não é um prompt genérico para “organizar minhas notas”. O guia da vault-cleanup-auditor foi construído em torno de um fluxo de auditoria fixo, um requisito explícito de entrada e um arquivo de relatório salvo. Isso a torna melhor para manutenção recorrente e automação de workflow do que para reestruturação subjetiva de notas.

Como usar a skill vault-cleanup-auditor

Instalação e configuração da vault-cleanup-auditor

Instale a skill vault-cleanup-auditor no Claude Code e aponte-a para a raiz do seu vault do Obsidian. A entrada principal de que ela precisa é o caminho absoluto do vault, não uma pasta dentro dele. Se você pular essa etapa, a skill foi desenhada para pedir o caminho ausente antes de executar.

Como acionar a auditoria

Um prompt prático de uso da vault-cleanup-auditor é simples e específico:
Run the Vault Cleanup Auditor skill against my vault at /path/to/vault.

Normalmente isso já basta, porque a skill já sabe o que verificar. Se o seu vault tiver subpastas incomuns ou você quiser revisar apenas um subconjunto, deixe isso claro logo no início para que a auditoria não faça uma varredura ampla demais ou estreita demais.

O que ler primeiro

Para revisar a instalação da vault-cleanup-auditor, comece por SKILL.md e SKILL-OC.md. Em SKILL.md, foque na fase de entrada e nas quatro verificações para entender exatamente o que vai acontecer. Vale também inspecionar a árvore de arquivos no repositório do GitHub para localizar os caminhos de suporte, mas esta skill não tem rules/, resources/ ou scripts extras para interpretar.

Melhor entrada para obter melhor saída

As melhores entradas de uso da vault-cleanup-auditor incluem um caminho absoluto limpo e uma expectativa clara sobre o que significa “bagunçado” no seu fluxo de trabalho. Por exemplo, especifique se rascunhos com mais de 30 dias devem ser tratados como desatualizados, se conteúdo arquivado deve ser ignorado e se nomes de arquivos duplicados entre seções são aceitáveis. Esses detalhes reduzem falsos positivos e tornam o relatório mais acionável.

FAQ da skill vault-cleanup-auditor

A vault-cleanup-auditor é só para Obsidian?

Sim, a skill é centrada em uma estrutura de vault do Obsidian e pressupõe arquivos markdown locais. Ela ainda pode ser útil para outros sistemas de notas baseados em pastas, mas as verificações nativas são ajustadas para conteúdo no estilo Obsidian e talvez precisem de adaptação.

Isso é melhor do que um prompt normal?

Geralmente, sim, se você quer a mesma auditoria toda vez. Um prompt comum pode pedir ideias de limpeza, mas a vault-cleanup-auditor adiciona um padrão fixo de varredura, tratamento obrigatório de entrada e um relatório salvo, o que torna os resultados mais repetíveis e mais fáceis de comparar mês a mês.

Iniciantes precisam conhecer a estrutura do repositório?

Não, mas iniciantes devem ler as seções curtas de instrução antes de executar. O principal é entender que a vault-cleanup-auditor não começa sem o caminho do vault e que ela espera a raiz real do vault para que as verificações consigam percorrer as pastas corretas.

Quando eu não devo usar?

Não use a vault-cleanup-auditor se você quiser reescritas editoriais amplas, orientação de estratégia de conteúdo ou julgamento em estilo humano sobre a qualidade das notas. Ela é uma auditora de limpeza, não uma assistente de escrita, e é mais valiosa quando a pergunta é: “o que está desatualizado, quebrado, duplicado ou vazio?”

Como melhorar a skill vault-cleanup-auditor

Delimite melhor o escopo

A forma mais eficaz de melhorar os resultados da vault-cleanup-auditor é definir claramente o limite do vault. Se o seu vault contém arquivos arquivados, backups sincronizados, templates ou conteúdo gerado, diga isso explicitamente. Isso ajuda a skill a não tratar armazenamento intencional como bagunça.

Ajuste os critérios da auditoria

Se as verificações padrão estiverem amplas demais ou rígidas demais, refine a interpretação das regras no seu pedido. Por exemplo, diga se “desatualizado” significa 30 dias ou 90 dias, se pastas vazias dentro de um sistema de templates devem ser ignoradas e se nomes de arquivos duplicados importam só dentro de um projeto ou em todo o vault.

Melhore o primeiro relatório

A primeira saída é mais útil quando o caminho do vault está correto e suas convenções de notas são consistentes. Se aparecerem muitos resultados ruidosos, o problema geralmente é a higiene da entrada: arquivos sem títulos, status de rascunho misturados ou nomes duplicados que na verdade são intencionais. Corrija a convenção ou descreva a exceção e, então, rode novamente o guia vault-cleanup-auditor.

Itere no que mais importa

Depois da primeira execução, revise os achados de maior prioridade antes de mudar a skill em si. A maioria dos usuários se preocupa mais com rascunhos desatualizados e nomes de arquivos duplicados, porque esses pontos geram mais custo de manutenção. Se o relatório deixar passar algo importante, atualize suas instruções com um exemplo concreto em vez de pedir uma auditoria “melhor” de forma genérica.