Obsidian Skills 소개
Obsidian Skills는 옵시디언(Obsidian)의 CEO인 Steph Ango (kepano)가 공개한 오픈소스 프로젝트로, Anthropic의 최신 CLI 기반 AI 에이전트인 Claude Code가 사용자의 로컬 옵시디언 볼트(Vault)를 자유자재로 제어할 수 있도록 설계된 '도구(Tool) 모음'이자 '설정(Configuration)'입니다.
우리는 지금까지 AI를 웹 브라우저나 특정 애플리케이션의 사이드바에 갇힌 챗봇 형태로 주로 사용해 왔습니다. 하지만 이 프로젝트는 AI를 파일 시스템이라는 운영체제의 핵심 영역으로 끌어들입니다. Obsidian Skills를 탑재한 Claude Code는 단순한 대화 상대를 넘어, 사용자의 로컬 폴더에 저장된 수천 개의 마크다운 파일들을 직접 읽고, 분석하고, 수정하고, 새로운 문서를 생성하는 실질적인 '동료'로서 기능합니다. 이는 옵시디언이 추구하는 철학인 File over App (앱보다 데이터인 파일이 우선한다) 을 AI 에이전트 시대에 맞게 재해석한 것으로, 로컬 우선(Local-first) 소프트웨어가 AI와 결합했을 때 얼마나 강력한 확장성을 가질 수 있는지 보여주는 중요한 사례입니다.
Obsidian Skills 프로젝트의 핵심은 Claude Code라는 에이전트에게 옵시디언의 데이터 구조와 사용자의 의도를 이해시키는 기술(Skills)을 가르치는 데 있습니다. 에이전트는 이 스킬들을 통해 오늘 날짜의 데일리 노트를 찾아내거나, 특정 주제와 관련된 과거의 기록들을 시맨틱하게 검색하고, 사용자의 문체나 선호도를 별도의 메모리 파일에 저장해두었다가 다음 작업에 반영하는 등 고차원적인 지식 관리 작업을 수행하게 됩니다. 결과적으로 개발자나 지식 노동자는 터미널 창 하나만으로 자신의 방대한 개인 지식 베이스(Second Brain)를 관리하고 확장하는 강력한 워크플로우를 구축할 수 있습니다.
기존 AI 플러그인과 비교: 앱 내부 대리인 vs 시스템 레벨 관리자
기존의 옵시디언 생태계에도 'Copilot'이나 'Smart Connections'와 같은 훌륭한 AI 플러그인들이 존재합니다. 하지만 이들과 Obsidian Skills는 근본적인 작동 위치와 권한의 범위에서 확연한 차이를 보입니다.
기존 플러그인들은 옵시디언이라는 애플리케이션 '내부'에서 구동됩니다. 이들은 옵시디언이 제공하는 플러그인 API에 의존하며, 앱이 실행 중일 때만 동작합니다. 주로 현재 열려 있는 노트를 요약하거나, 사이드바에서 질의응답을 하는 보조적인 역할에 집중되어 있습니다. 반면, Obsidian Skills는 옵시디언 앱과는 무관하게 터미널(Terminal) 환경에서 시스템 레벨로 작동합니다. 즉, 옵시디언 앱이 꺼져 있어도 Claude Code는 파일 시스템에 직접 접근하여 수백 개의 파일을 일괄적으로 리팩토링하거나, Git과 연동하여 변경 사항을 커밋하고 푸시하는 등의 광범위한 작업을 수행할 수 있습니다.
또한 기존 방식이 사용자에게 완성된 결과를 '제안'하는 데 그쳤다면, Obsidian Skills를 장착한 에이전트는 사용자의 명시적인 명령에 따라 파일을 직접 '조작'하고 '완결' 짓는 에이전트적 성격이 훨씬 강합니다. 이는 단순한 텍스트 생성이 아니라, 파일 생성, 폴더 구조 정리, 링크 연결과 같은 구조적인 관리를 자동화할 수 있음을 의미합니다.
Obsidian Skills의 주요 기능
Obsidian Skills는 Claude Code가 실행될 때 로드되는 일련의 프롬프트 정의와 도구 설정으로 구성되어 있습니다. 이를 통해 에이전트는 다음과 같은 구체적인 능력들을 갖추게 됩니다.
시공간을 이해하는 에이전트: 데일리 노트와 시간 관리
일반적인 LLM은 '오늘'이 언제인지, '지난주 화요일'이 며칠인지에 대한 감각이 부족하여 로컬 파일 관리에 어려움을 겪곤 합니다. Obsidian Skills는 에이전트에게 현재 날짜와 시간을 정확히 인지하고, 이를 옵시디언의 데일리 노트 형식(예: YYYY-MM-DD.md)으로 변환하는 로직을 제공합니다.
예를 들어, 사용자가 "지난주 회의록을 찾아서 오늘 데일리 노트의 할 일 목록에 추가해줘"라고 자연어로 요청하면, 에이전트는 스스로 날짜를 계산하여 정확한 파일 경로를 찾아내고, 해당 파일이 없다면 템플릿에 맞춰 새로 생성한 뒤 내용을 기입합니다. 이는 AI가 사용자의 시간적 맥락(Context) 안으로 들어오게 만드는 핵심 기능입니다.
영속적인 기억 장치: 메모리(Memory) 시스템
대부분의 AI 채팅 세션은 대화가 끝나면 사라집니다. 매번 "나는 파이썬 개발자이고 간결한 문체를 좋아해" 같은 식으로 다시 설명해야 하는 번거로움이 있습니다. 이러한 방식에 비해, Obsidian Skills는 Memory.md라는 별도의 파일을 통해 에이전트에게 영구적인 기억을 부여합니다.
예를 들어, 사용자가 대화 중에 "나는 리스트보다는 서술형 줄글을 선호해"라고 말하면, 에이전트는 이 정보를 스스로 Memory.md 파일에 기록해 둡니다. 이후 새로운 작업을 시작할 때 에이전트는 항상 이 메모리 파일을 먼저 참조(Read)하여 사용자의 선호도, 현재 진행 중인 프로젝트의 상태, 주의해야 할 사항 등을 사전에 파악하고 맞춤형 답변을 제공합니다. 이는 AI를 단순한 도구가 아닌, 시간이 지날수록 나와 합이 잘 맞는 파트너로 성장시키는 메커니즘입니다.
문맥 기반 탐색과 정보 합성: 검색(Search) 및 읽기(Read)
옵시디언 볼트(Obsidian Vault)가 커질수록 원하는 정보를 찾는 것은 어려워집니다. Obsidian Skills는 단순한 키워드 매칭을 넘어선 검색 능력을 제공합니다. 에이전트는 사용자의 모호한 요청(예: "작년에 구상했던 마케팅 아이디어들 좀 찾아줘")을 받으면, grep이나 관련 검색 도구를 활용하여 파일 내용을 훑고, 가장 연관성이 높은 파일들을 선별하여 내용을 읽어들입니다(Read Note).
중요한 점은 단순히 검색 결과 목록을 던져주는 것이 아니라, 여러 노트에 흩어진 정보를 종합(Synthesis)하여 하나의 완성된 답변으로 재구성한다는 점입니다. 이 과정에서 에이전트는 링크된 다른 문서들을 따라가며 탐색(Crawl)할 수도 있어, 파편화된 지식들을 연결하는 인사이트를 제공합니다.
Obsidian Skills의 설치 및 실행 환경
Obsidian Skills의 모든 기능은 Anthropic의 Claude Code 환경 위에서 돌아갑니다. 따라서, 사용자는 Obsidian Skills 사용을 위해 이미 터미널에서 Claude Code를 인증하고 실행한 상태여야 합니다.
설치 방법은 일반적인 Claude Code Plugin 설치와 동일합니다. 다음과 같이 Marketplace를 먼저 지정한 다음, 스킬을 설치하면 됩니다:
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills
설치가 완료되면 별도의 복잡한 설정 없이 자연어로 "내 볼트에서 OOO를 해줘"라고 명령하는 것만으로 모든 기능을 활용할 수 있습니다.
라이선스
Obisdian Skills 프로젝트는 MIT 라이선스를 따르고 있습니다. 따라서 개인이나 기업, 누구나 자유롭게 사용, 수정 및 배포가 가능합니다.
Obsidian Skills 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 