vault-cleanup-auditor

vault-cleanup-auditor 스킬 개요

vault-cleanup-auditor가 하는 일

vault-cleanup-auditor 스킬은 Claude Code에서 Obsidian vault를 감사하고, 날짜가 포함된 정리 보고서를 생성합니다. 오래된 초안, 미완성 노트, 중복 파일명, 빈 폴더를 찾아낸 뒤, 바로 실행할 수 있도록 우선순위를 매긴 검토 목록으로 정리해 줍니다.

이런 분께 적합합니다

성장 중인 개인 또는 팀 vault를 관리하고 있고, 일회성 프롬프트가 아니라 반복 가능한 정리 점검이 필요하다면 vault-cleanup-auditor 스킬을 사용하세요. 이미 vault 구조는 갖춰져 있지만, 흐트러짐이나 잡음, 끝내지 못한 콘텐츠를 빠르게 찾아내고 싶은 사람에게 특히 유용합니다.

무엇이 다른가

이건 단순한 “노트를 정리해 달라” 프롬프트가 아닙니다. vault-cleanup-auditor 가이드는 고정된 감사 워크플로, 명시적인 입력 요건, 저장되는 보고서 파일을 중심으로 설계되어 있습니다. 그래서 주관적인 노트 재구성보다 반복 유지보수와 Workflow Automation에 더 잘 맞습니다.

vault-cleanup-auditor 스킬 사용 방법

vault-cleanup-auditor 설치 및 설정

Claude Code에 vault-cleanup-auditor 스킬을 설치한 뒤, Obsidian vault의 루트 경로를 지정하세요. 핵심 입력은 vault 내부의 하위 폴더가 아니라 vault 전체의 절대 경로입니다. 이 값이 없으면, 스킬은 실행 전에 누락된 경로를 먼저 요청하도록 설계되어 있습니다.

감사 실행 방법

vault-cleanup-auditor를 실행할 때는 아래처럼 간단하고 구체적으로 요청하면 충분합니다.
Run the Vault Cleanup Auditor skill against my vault at /path/to/vault.

스킬이 무엇을 점검해야 하는지 이미 알고 있기 때문에, 보통 이것만으로도 충분합니다. vault에 특이한 하위 폴더 구조가 있거나 일부만 점검하고 싶다면, 처음부터 그 범위를 명시하세요. 그래야 과도하게 넓게 보거나, 반대로 빠뜨리는 일이 없습니다.

먼저 읽어야 할 것

vault-cleanup-auditor 설치 검토는 SKILL.md와 SKILL-OC.md부터 시작하세요. SKILL.md에서는 입력 단계와 네 가지 점검 항목에 집중해, 실제로 어떤 흐름으로 진행되는지 정확히 파악하는 것이 좋습니다. GitHub repo의 파일 트리도 함께 살펴 지원 경로를 확인할 수 있지만, 이 스킬에는 별도의 rules/, resources/, 스크립트를 해석할 요소가 없습니다.

더 좋은 결과를 위한 입력 방법

vault-cleanup-auditor를 잘 쓰려면, 깔끔한 절대 경로와 함께 작업 기준에서 “지저분함”이 무엇인지 분명히 적어주는 것이 가장 중요합니다. 예를 들어 30일이 지난 초안을 stale로 볼지, 보관된 콘텐츠는 제외할지, 섹션이 달라도 중복 파일명을 허용할지 등을 지정하세요. 이런 조건을 넣으면 오탐이 줄고, 보고서의 실행 가능성도 높아집니다.

vault-cleanup-auditor 스킬 FAQ

vault-cleanup-auditor는 Obsidian 전용인가요?

네, 이 스킬은 Obsidian vault 구조를 기준으로 하며 로컬 markdown 파일을 전제로 합니다. 다른 폴더 기반 노트 시스템에도 어느 정도 쓸 수는 있지만, 기본 점검 항목은 Obsidian 스타일 콘텐츠에 맞춰져 있어서 조정이 필요할 수 있습니다.

일반 프롬프트보다 나은가요?

같은 감사를 매번 반복하고 싶다면 대체로 그렇습니다. 일반 프롬프트로도 정리 아이디어를 요청할 수는 있지만, vault-cleanup-auditor는 고정된 스캔 패턴, 필수 입력 처리, 저장되는 보고서를 제공하므로 결과를 더 반복 가능하게 만들고 월별 비교도 훨씬 쉬워집니다.

초보자도 repo 구조를 알아야 하나요?

아니요. 다만 실행 전에 짧은 안내 섹션은 읽는 것이 좋습니다. 가장 중요한 점은 vault-cleanup-auditor가 vault 경로가 없으면 시작하지 않는다는 것, 그리고 실제 vault 루트가 있어야 올바른 폴더를 순회하며 점검할 수 있다는 점입니다.

언제 쓰지 말아야 하나요?

폭넓은 편집 재작성, 콘텐츠 전략 조언, 노트 품질에 대한 사람 같은 판단이 필요할 때는 vault-cleanup-auditor를 쓰지 마세요. 이건 글쓰기 도우미가 아니라 정리 감사 도구이며, “무엇이 오래됐고, 깨졌고, 중복됐고, 비어 있는가?”를 묻는 상황에서 가장 가치가 큽니다.

vault-cleanup-auditor 스킬 개선 방법

범위를 더 명확하게 정하세요

vault-cleanup-auditor 결과를 가장 크게 개선하는 방법은 vault의 경계를 분명히 정의하는 것입니다. vault 안에 archives, 동기화된 백업, templates, 생성 콘텐츠가 들어 있다면, 그것도 명시하세요. 그래야 스킬이 의도된 저장 공간을 잡음으로 오해하지 않습니다.

감사 기준을 조정하세요

기본 점검이 너무 느슨하거나 너무 엄격하다면, 요청 문구에서 규칙 해석을 더 구체화하세요. 예를 들어 “stale”의 기준이 30일인지 90일인지, 템플릿 시스템 아래의 빈 폴더를 무시할지, 중복 파일명이 한 프로젝트 안에서만 문제가 되는지 아니면 전체 vault에서 문제인지 알려주면 됩니다.

첫 보고서를 더 좋게 만드세요

첫 출력은 vault 경로가 정확하고 노트 규칙이 일관될수록 가장 유용합니다. 결과가 너무 지저분하게 나오면, 문제는 대개 입력 정리 상태에 있습니다. 예를 들어 제목이 없는 파일, 섞여 있는 초안 상태, 사실은 의도된 중복 이름이 원인일 수 있습니다. 규칙을 바로잡거나 예외를 설명한 뒤 vault-cleanup-auditor 가이드를 다시 실행하세요.

가장 중요한 것부터 반복해서 다듬으세요

첫 실행 후에는 스킬 자체를 바꾸기 전에 우선순위가 높은 항목부터 검토하세요. 대부분의 사용자는 오래된 초안과 중복 파일명에 가장 큰 관심을 가집니다. 왜냐하면 이런 항목이 유지보수 부담을 가장 크게 키우기 때문입니다. 보고서가 놓치는 중요한 항목이 있다면, 더 넓은 “더 나은 감사”를 요청하기보다 구체적인 예시 하나를 넣어 지시를 업데이트하세요.