菜单
Use when user says "vault lint", "노트 점검", "vault 정리", "orphan notes", "링크 점검", or wants to check Obsidian vault health. Do NOT use for individual note creation (use obsidian-note) or tag management (use til-tagger).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when GenOS 작업에서 얻은 재사용 가능한 지식(플랫폼 패턴·함정·고객사 결정)을 개인 Obsidian vault(Projects/GenonAI)에 기록할 가치가 생겼거나, GenOS 작업 맥락에서 사용자가 "지식 캡처", "vault에 정리/기록", "MOC", "읽는 순서", "field note", "/genos-knowledge-capture"를 요청할 때 사용. Do NOT use for: GenOS와 무관한 노트, 웹 리서치 기반 일반 개념 노트, 단순 진행상황·세션 상태.
Use when user says "wiki compile", "위키 컴파일", "raw 정리", "지식 컴파일", "소스 컴파일", or wants to compile raw sources into a structured wiki. Do NOT use for individual note creation (use obsidian-note) or vault maintenance (use vault-linter).
Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts. Use when user says "다이어그램", "diagram", "excalidraw", "시각화", "아키텍처 그려". Do NOT use for Mermaid diagrams or draw.io.
Use when user mentions "Obsidian", "옵시디언", "write as note", "save to notes", "노트로 저장", or /obsidian-note command. Do NOT use for TIL (use til), YouTube notes (use youtube-summarizer), GenOS 작업 지식 캡처 (use genos-knowledge-capture), or deep/team/multi-angle note research (use agentic-notes).
Use when the user asks to create an Obsidian note with an agent team, deep research, strict verification, multiple angles, or phrases like "팀으로 조사해서 노트", "깊게 조사해서 옵시디언 노트", "/agentic-notes", "--team", "--verify strict", or "--deep". Do NOT use for a simple one-shot Obsidian note; use obsidian-note instead.
Use when user says "commit and push", "커밋하고 푸시", "올려줘", "저장하고 올려". Do NOT use for commit-only (use git-commit) or push-only (use git-push).
| name | vault-linter |
| description | Use when user says "vault lint", "노트 점검", "vault 정리", "orphan notes", "링크 점검", or wants to check Obsidian vault health. Do NOT use for individual note creation (use obsidian-note) or tag management (use til-tagger). |
Obsidian Vault의 건강 상태를 점검하고 지식 그래프의 일관성을 유지하는 스킬. Karpathy의 "LLM Knowledge Base Linting" 패턴.
| 항목 | 값 |
|---|---|
| Vault 경로 | ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/Note |
| 기본 산출물 | _Inbox/Vault-Index.md |
| 진단 리포트 저장 위치 | _Inbox/Vault-Lint-Report-{YYYY-MM-DD}.md (명시적으로 리포트를 요청한 경우만) |
| 검사 제외 | Templates/, .obsidian/, Vault-Lint-Report*, Vault-Semantic-Report*, Vault-Index.md, Vault-Log.md |
/vault-linter # 전체 점검
/vault-linter --orphans # 고아 노트만
/vault-linter --links # 깨진 링크만
/vault-linter --stale # 오래된 노트만
/vault-linter --suggestions # 새 노트 후보만
/vault-linter --semantic # 의미 기반 유사 노트 연결
/vault-linter --index # Vault 인덱스만 갱신
/vault-linter --report # 명시적으로 Vault-Lint-Report 생성
| 스크립트 | 용도 |
|---|---|
scripts/vault-scan.sh list-notes | 제외 대상 빼고 전체 노트 목록 출력 |
scripts/vault-scan.sh extract-links <file> | 파일에서 [[wikilink]] 추출 (alias 처리 포함) |
scripts/vault-scan.sh check-links <file> | 깨진 링크만 출력 |
scripts/vault-scan.sh check-links-all | 전체 vault의 깨진 링크를 한 번의 노트 인덱스로 TSV 출력 |
scripts/vault-scan.sh find-orphans | 어디서도 참조되지 않은 노트 목록 |
scripts/vault-scan.sh tag-list | 태그별 사용 횟수 |
scripts/semantic-linker.py | bge-m3 임베딩 + 코사인 유사도 후보 추출 |
scripts/semantic-linker.py --cache-only | 임베딩 캐시만 빌드 (유사도 계산 생략) |
scripts/vault-index.py | 폴더별 노트 카탈로그 생성 |
스크립트가 결정적 검증을 수행하고, Claude는 결과를 해석하고 제안한다.
bash scripts/vault-scan.sh list-notes
결과로 전체 노트 목록을 확보. 이후 단계에서 스크립트를 활용한다.
bash scripts/vault-scan.sh find-orphans
결과로 나온 고아 노트에 대해 tags와 키워드 기반으로 연결 후보를 제안한다.
각 노트에 대해:
bash scripts/vault-scan.sh check-links "$NOTE"
깨진 링크가 발견되면 "새 노트를 만들까요?" 또는 "링크를 제거할까요?" 제안.
90일 이상 된 노트 중, 버전/날짜 의존적 내용이 있는 것을 찾는다.
created → 없으면 파일 수정 시간(stat -f %Sm macOS / stat -c %y Linux)202X), 버전(v1.x, 버전 N), "최신", "현재" 등 시간 의존적 표현 검색모든 태그를 수집하여 유사하지만 다른 태그 쌍을 찾는다.
대소문자 차이(ai/llm vs ai/LLM), 유사 표현(database/sql vs db/sql) 등을 탐지하고 통일 제안.
여러 노트의 ## 더 알아보기 섹션에서 공통 언급 주제를 추출한다.
Wiki/_INDEX.md에 누락된 아티클이 있는지 점검한다.
Wiki/ 폴더의 .md 파일 목록 수집 (_INDEX.md 제외)Wiki/_INDEX.md 본문에서 [[...]] wikilink 추출누락 파일이 있으면:
## 섹션)를 추천📋 Wiki INDEX 동기화
├── 누락: 3개
│ ├── Spring-AI-ChatClient.md → "## Spring > Spring AI" 추천
│ ├── Docker-Compose-v2.md → "## Docker / DevOps" 추천
│ └── RAG-패턴.md → "## AI / LLM" 추천
└── 깨진 참조: 0개
--report 명시 시에만)기본 실행과 --index 실행은 Obsidian vault에 Vault-Lint-Report-*를 남기지 않는다.
사용자가 명시적으로 진단 리포트를 요청했을 때만 결과를 _Inbox/Vault-Lint-Report-{YYYY-MM-DD}.md에 저장한다.
---
tags:
- vault/maintenance
created: {YYYY-MM-DD}
---
## Vault Lint Report — {YYYY-MM-DD}
### 요약
| 항목 | 건수 | 심각도 |
|------|------|--------|
| 고아 노트 | N건 | ⚠️ |
| 깨진 링크 | N건 | 🚫 |
| 오래된 노트 | N건 | 💡 |
| 태그 비일관성 | N건 | 💡 |
| INDEX 누락 | N건 | 📋 |
| 새 노트 후보 | N건 | ✨ |
### 🚫 깨진 링크
| 노트 | 깨진 링크 | 제안 |
|------|-----------|------|
| [[노트A]] | [[존재하지않는것]] | 새 노트 생성 or 링크 제거 |
### ⚠️ 고아 노트
| 노트 | 연결 후보 |
|------|-----------|
| [[고아노트]] | [[관련노트]] (태그 매칭) |
### 💡 오래된 노트
| 노트 | 생성일 | 시간 의존적 내용 |
|------|--------|-----------------|
| [[구형노트]] | 2025-01-01 | "v2.x 기준" 언급 |
### 💡 태그 비일관성
| 태그 A | 태그 B | 건수 | 통일 제안 |
|--------|--------|------|-----------|
| ai/llm | ai/LLM | 5+2 | ai/llm |
### ✨ 새 노트 후보
| 주제 | 언급 노트 수 | 출처 노트 |
|------|-------------|-----------|
| RAG vs Long Context | 3 | [[A]], [[B]], [[C]] |
--semanticollama list | grep bge-m3
bge-m3가 없으면:
ollama pull bge-m3
python3 scripts/semantic-linker.py
JSON 출력의 candidate_pairs를 파싱한다.
리뷰 큐 파일이 있으면 이어서 진행:
ls scripts/semantic-review-queue.json 2>/dev/null && echo "리뷰 큐 있음 — 이어가기 모드"
리뷰 큐가 있으면 next_batch_start부터 batch_size(50)만큼 읽어서 처리하고, llm_reviewed: true로 업데이트. 없으면 새로 시작.
각 후보 쌍에 대해:
related_notes에 [[상대노트]] 추가_Inbox/Vault-Semantic-Report-{YYYY-MM-DD}.md에 저장:
---
tags:
- vault/maintenance
created: {YYYY-MM-DD}
---
## Vault Semantic Link Report — {YYYY-MM-DD}
### 요약
| 항목 | 건수 |
|------|------|
| 분석 노트 | N개 |
| 후보 쌍 | N개 |
| 연결 완료 | N개 |
| 거절 | N개 |
### 새 연결
| Note A | Note B | 유사도 | 관계 유형 |
|--------|--------|--------|----------|
| [[A]] | [[B]] | 0.82 | 보충 |
### 거절된 쌍
| Note A | Note B | 유사도 | 거절 사유 |
|--------|--------|--------|----------|
| [[C]] | [[D]] | 0.76 | 키워드 우연 겹침 |
--index카파시의 "LLM Wiki" 패턴에서 index.md는 LLM이 vault 탐색 시 가장 먼저 읽는 메타 레이어다. 매번 전체 노트를 Glob 하지 않고, 카탈로그에서 관련 폴더를 좁히고 진입한다.
python3 scripts/vault-index.py
동작:
_Inbox/Vault-Index.md 전체 덮어쓰기 (폴더별 노트 + 본문 첫 줄 요약)_Inbox/Vault-Log.md는 생성하지 않음_Inbox/Vault-Lint-Report-{YYYY-MM-DD}.md는 생성하지 않음□ 제외 대상(Templates, .obsidian)을 빼고 스캔했는가
□ 깨진 링크에서 Obsidian alias([[이름|별칭]])를 올바르게 처리했는가
□ `--index` 실행은 `Vault-Index.md`만 생성/갱신했는가
□ 리포트는 사용자가 명시적으로 요청한 경우에만 _Inbox에 저장했는가
□ 고아 노트에 구체적 연결 후보를 제안했는가
□ 새 노트 후보의 출처 노트를 명시했는가
□ 각 플래그(--orphans, --links 등) 단독 실행이 가능한 구조인가
□ --semantic 실행 전 ollama + bge-m3 설치를 확인했는가
□ 이미 연결된 노트 쌍을 중복 제안하지 않았는가
□ --index는 Vault-Index.md 덮어쓰기만 수행했는가
[[파일명|표시명]]에서 파일명만 추출해야 함 — vault-scan.sh가 처리--stale의 tavily_search는 시간이 오래 걸릴 수 있음 — 노트 수가 많으면 상위 5개만 점검--orphans도 대형 vault(300+)에서 느릴 수 있음 — vault-scan.sh가 xargs로 일괄 처리하므로 개별 grep보다 빠름--semantic 첫 실행 시 877개 임베딩 생성에 수 분 소요 — 이후 캐시로 신규/변경 노트만 처리ollama serve로 데몬 시작 필요할 수 있음--index의 요약은 본문 첫 줄(heading/frontmatter/table row 제외)을 100자로 자름 — 프론트매터에 description: 필드가 있으면 나중에 그걸 우선 쓰도록 확장 가능