obsidian-vault
Obsidian vault 및 마크다운 문서 작업 시 사용. markdown-oxide LSP를 통한 효율적인 검색, 백링크 탐색, 태그 관리 지원. vault 경로, 태그 체계, vault-intelligence CLI, 토큰 최적화 전략 제공. Obsidian, vault, 마크다운, 태그, 노트 정리, zettelkasten, 백링크, wiki-link, PKM 관련 작업 시 자동 적용.
Best use case
obsidian-vault is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Obsidian vault 및 마크다운 문서 작업 시 사용. markdown-oxide LSP를 통한 효율적인 검색, 백링크 탐색, 태그 관리 지원. vault 경로, 태그 체계, vault-intelligence CLI, 토큰 최적화 전략 제공. Obsidian, vault, 마크다운, 태그, 노트 정리, zettelkasten, 백링크, wiki-link, PKM 관련 작업 시 자동 적용.
Teams using obsidian-vault should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/obsidian-vault/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How obsidian-vault Compares
| Feature / Agent | obsidian-vault | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Obsidian vault 및 마크다운 문서 작업 시 사용. markdown-oxide LSP를 통한 효율적인 검색, 백링크 탐색, 태그 관리 지원. vault 경로, 태그 체계, vault-intelligence CLI, 토큰 최적화 전략 제공. Obsidian, vault, 마크다운, 태그, 노트 정리, zettelkasten, 백링크, wiki-link, PKM 관련 작업 시 자동 적용.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Obsidian Vault 작업 가이드 ## 경로 정보 | 항목 | 경로 | |------|------| | vault | `$VAULT_ROOT` (글로벌 CLAUDE.md 참조) | | vault-intelligence | `~/git/vault-intelligence/` | ## markdown-oxide LSP 활용 ### 사용 가능한 LSP 기능 markdown-oxide MCP 서버가 연결되어 있으면 다음 기능을 활용할 수 있다: 1. **Go to Definition**: `[[링크]]` → 해당 파일로 이동 2. **Find References (백링크)**: 특정 노트를 참조하는 모든 노트 검색 3. **Tag Search**: `#태그`가 사용된 모든 위치 검색 4. **Completion**: 링크, 태그, 프로퍼티 자동완성 5. **Diagnostics**: 깨진 링크, 존재하지 않는 노트 감지 ### LSP 기반 검색 예시 ``` # 백링크 찾기 "TDD 노트를 참조하는 모든 노트 찾아줘" → LSP find_references 사용 # 태그 검색 "#project/active 태그가 있는 노트들 찾아줘" → LSP find_references 사용 # 깨진 링크 확인 "이 vault에서 깨진 링크가 있는 노트 확인해줘" → LSP diagnostics 사용 ``` ### LSP 우선 원칙 마크다운 파일 검색 시: 1. **우선**: markdown-oxide LSP 도구 사용 (빠르고 정확) 2. **차선**: vis CLI (시맨틱 검색 필요 시) 3. **최후**: 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 ### 기본 사용법 ```bash # 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` ## 토큰 최적화 전략 ### 작업 원칙 1. **한 번에 10개 이하 파일 처리** 2. **archive, .obsidian 폴더 무시** 3. **MOC 노트 먼저 읽고 관련 노트만 선택적 로드** 4. **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
weekly-newsletter
Obsidian vault에서 이번 주(토~금) 작성/수정된 글들을 모아 뉴스레터 생성. 서브 에이전트 기반 병렬 처리로 메인 컨텍스트 절약. 기술적, 리더십적으로 외부에 공유할 만한 내용을 선별하여 정리. "뉴스레터 만들어줘", "이번 주 글 정리해줘", "weekly digest" 등의 요청 시 자동 적용.
vis
Vault Intelligence System (vis) CLI를 활용한 Obsidian vault 시맨틱 검색, 자동 태깅, MOC 생성, 관련 문서 연결, 주제별 문서 연결, 주제 수집, 태그 통계, 지식 공백 분석, 중복 감지, 학습 리뷰 등 vault 지식 관리 전반을 지원하는 skill. vault 검색, 문서 정리, 태그, MOC, 관련 문서, 주제 수집, 중복 검사, 학습 리뷰, 지식 공백, 클러스터링, 인덱싱, 주제별 문서 연결, 태그 통계 관련 작업 시 자동 적용.
spark-python-data-source
Build custom Python data sources for Apache Spark using the PySpark DataSource API — batch and streaming readers/writers for external systems. Use this skill whenever someone wants to connect Spark to an external system (database, API, message queue, custom protocol), build a Spark connector or plugin in Python, implement a DataSourceReader or DataSourceWriter, pull data from or push data to a system via Spark, or work with the PySpark DataSource API in any way. Even if they just say "read from X in Spark" or "write DataFrame to Y" and there's no native connector, this skill applies.
session-handoff
세션 종료 시 plan/INDEX/메모리/저널을 업데이트하고 다음 세션 재개 프롬프트 제공
searching-mlflow-docs
Searches and retrieves MLflow documentation from the official docs site. Use when the user asks about MLflow features, APIs, integrations (LangGraph, LangChain, OpenAI, etc.), tracing, tracking, or requests to look up MLflow documentation. Triggers on "how do I use MLflow with X", "find MLflow docs for Y", "MLflow API for Z".
retrieving-mlflow-traces
Retrieves MLflow traces using CLI or Python API. Use when the user asks to get a trace by ID, find traces, filter traces by status/tags/metadata/execution time, query traces, or debug failed traces. Triggers on "get trace", "search traces", "find failed traces", "filter traces by", "traces slower than", "query MLflow traces".
recall
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".
vercel-react-best-practices
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.
querying-mlflow-metrics
Fetches aggregated trace metrics (token usage, latency, trace counts, quality evaluations) from MLflow tracking servers. Triggers on requests to show metrics, analyze token usage, view LLM costs, check usage trends, or query trace statistics.
prompt-contracts
프롬프트 작성, brainstorming, planning, design, 설계, 기능 개발 시 Prompt Contracts 프레임워크 적용. Goal/Constraints/Format/Failure Conditions 4요소로 명확한 명세 작성. "바이브 코딩" 방지. brainstorming, writing-plans, 설계, 기능 구현 관련 작업 시 자동 적용.
jira
Use jira CLI for Jira operations including issue management, project queries, transitions, and JQL search
instrumenting-with-mlflow-tracing
Instruments Python and TypeScript code with MLflow Tracing for observability. Must be loaded when setting up tracing as part of any workflow including agent evaluation. Triggers on adding tracing, instrumenting agents/LLM apps, getting started with MLflow tracing, tracing specific frameworks (LangGraph, LangChain, OpenAI, DSPy, CrewAI, AutoGen), or when another skill references tracing setup. Examples - "How do I add tracing?", "Instrument my agent", "Trace my LangChain app", "Set up tracing for evaluation"