msbaek/obsidian-vault
.claude/skills/obsidian-vault/SKILL.md
Obsidian vault 및 마크다운 문서 작업 시 사용. markdown-oxide LSP를 통한 효율적인 검색, 백링크 탐색, 태그 관리 지원. vault 경로, 태그 체계, vault-intelligence CLI, 토큰 최적화 전략 제공. Obsidian, vault, 마크다운, 태그, 노트 정리, zettelkasten, 백링크, wiki-link, PKM 관련 작업 시 자동 적용.
$ install --global
skillsauthnpx skillsauth add msbaek/dotfiles obsidian-vaultInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 2:11 AM6.7s2 files scanned
SKILL.md
- name:
- obsidian-vault
- description:
- |
Obsidian Vault 작업 가이드
경로 정보
| 항목 | 경로 |
|------|------|
| vault | $VAULT_ROOT (글로벌 CLAUDE.md 참조) |
| vault-intelligence | ~/git/vault-intelligence/ |
markdown-oxide LSP 활용
사용 가능한 LSP 기능
markdown-oxide MCP 서버가 연결되어 있으면 다음 기능을 활용할 수 있다:
- Go to Definition:
[[링크]]→ 해당 파일로 이동 - Find References (백링크): 특정 노트를 참조하는 모든 노트 검색
- Tag Search:
#태그가 사용된 모든 위치 검색 - Completion: 링크, 태그, 프로퍼티 자동완성
- Diagnostics: 깨진 링크, 존재하지 않는 노트 감지
LSP 기반 검색 예시
# 백링크 찾기
"TDD 노트를 참조하는 모든 노트 찾아줘"
→ LSP find_references 사용
# 태그 검색
"#project/active 태그가 있는 노트들 찾아줘"
→ LSP find_references 사용
# 깨진 링크 확인
"이 vault에서 깨진 링크가 있는 노트 확인해줘"
→ LSP diagnostics 사용
LSP 우선 원칙
마크다운 파일 검색 시:
- 우선: markdown-oxide LSP 도구 사용 (빠르고 정확)
- 차선: vis CLI (시맨틱 검색 필요 시)
- 최후: grep/ripgrep (단순 텍스트 매칭)
태그 체계
Hierarchical Tags
- 형식:
#category/subcategory/detail - 5가지 카테고리: Topic, Document Type, Source, Status, Project
Zettelkasten 폴더 구조
| 폴더 | 용도 | 작업 권한 | |------|------|-----------| | 000-SLIPBOX | 개인 인사이트 | 읽기/쓰기 | | 001-INBOX | 수집함 | 읽기/쓰기 | | 003-RESOURCES | 참고자료 | 주로 읽기 | | archive | 보관 자료 | 접근 금지 |
상세 가이드
- 태그:
vault_root/vault-analysis/improved-hierarchical-tags-guide.md
vault-intelligence CLI
기본 사용법
# vis daemon 서버 실행 시 HTTP API 직접 호출 (0.4초, CLI는 9초)
curl -s --get --data-urlencode "query=검색어" "http://localhost:8741/search?search_method=hybrid&top_k=10" | jq -r '.results[] | "\(.score) \(.path)"'
# 서버 미실행 시 fallback
vis search "검색어" --search-method hybrid --top-k 10
주요 옵션
| 옵션 | 값 | 설명 |
|------|-----|------|
| --search-method | semantic, keyword, hybrid, colbert | hybrid 권장 |
| --rerank | (플래그) | 재순위화로 정확도 향상 |
| --expand | (플래그) | 쿼리 확장 (동의어 + HyDE) |
| --top-k | 숫자 | 반환 결과 수 |
자주 실수하는 옵션
| ❌ 잘못된 사용 | ✅ 올바른 사용 |
|---------------|---------------|
| --method | --search-method |
| --k | --top-k |
| --output-file | --output |
| --reranking | --rerank |
| vis search --query "TDD" | vis search "TDD" (positional) |
| vis collect --topic "TDD" | vis collect "TDD" (positional) |
| vis related --file "문서.md" | vis related "문서.md" (positional) |
| vis tag --target "문서.md" | vis tag "문서.md" (positional) |
상세 가이드
~/git/vault-intelligence/CLAUDE.md
토큰 최적화 전략
작업 원칙
- 한 번에 10개 이하 파일 처리
- archive, .obsidian 폴더 무시
- MOC 노트 먼저 읽고 관련 노트만 선택적 로드
- 20회 반복 후
/compact또는/clear
효율적인 요청 패턴
# ❌ 비효율적
"vault의 모든 파일을 분석해줘"
# ✅ 효율적
"003-RESOURCES에서 'kubernetes' 태그가 있는 노트 목록만 보여줘"
컨텍스트 관리
| 명령어 | 용도 | 시점 |
|--------|------|------|
| /compact | 히스토리 압축 | 70% 사용 시 |
| /clear | 초기화 | 새 작업 시작 |
| /cost | 토큰 확인 | 수시 |
파일 처리 시 주의사항
제외 대상
.obsidian/폴더archive/폴더.canvas파일- 이미지 파일 (
.png,.jpg,.gif등)
오류 처리
- 읽기 오류 파일은
UNPROCESSED-FILES.md에 기록 - 인코딩 문제 시 UTF-8로 재시도
검색 도구 선택 가이드
| 검색 유형 | 권장 도구 | |-----------|-----------| | 백링크/참조 관계 | markdown-oxide LSP | | 태그 기반 검색 | markdown-oxide LSP | | 시맨틱 검색 (의미 기반) | vis | | 단순 키워드 매칭 | ripgrep | | 파일명 검색 | glob/find |
Related Skills
msbaek/weekly-newsletter
tools
VerifiedTrustedCommunity
Obsidian vault에서 이번 주(토~금) 작성/수정된 글들을 모아 뉴스레터 생성. 서브 에이전트 기반 병렬 처리로 메인 컨텍스트 절약. 기술적, 리더십적으로 외부에 공유할 만한 내용을 선별하여 정리. "뉴스레터 만들어줘", "이번 주 글 정리해줘", "weekly digest" 등의 요청 시 자동 적용.
39SKILL.mdUpdated Apr 17, 2026
msbaek/vis
tools
VerifiedTrustedCommunity
Vault Intelligence System (vis) CLI를 활용한 Obsidian vault 시맨틱 검색, 자동 태깅, MOC 생성, 관련 문서 연결, 주제별 문서 연결, 주제 수집, 태그 통계, 지식 공백 분석, 중복 감지, 학습 리뷰 등 vault 지식 관리 전반을 지원하는 skill. vault 검색, 문서 정리, 태그, MOC, 관련 문서, 주제 수집, 중복 검사, 학습 리뷰, 지식 공백, 클러스터링, 인덱싱, 주제별 문서 연결, 태그 통계 관련 작업 시 자동 적용.
39SKILL.mdUpdated Apr 17, 2026
msbaek/recall
data-ai
VerifiedTrustedCommunity
Load context from vault memory. Temporal queries (yesterday, last week, session history) use agf (history.jsonl) for fast session lookup. Topic queries use vis semantic search. "recall graph" generates interactive temporal graph of sessions and files. Every recall ends with "One Thing" - the single highest-leverage next action synthesized from results. Use when user says "recall", "what did we work on", "load context about", "remember when we", "prime context", "yesterday", "what was I doing", "last week", "session history", "recall graph", "session graph".
39SKILL.mdUpdated Apr 17, 2026
msbaek/vercel-react-best-practices
development
VerifiedTrustedCommunity
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
39SKILL.mdUpdated Apr 17, 2026