옵시디언 AI, 독서 메모 주면 클로드가 표·관계도까지

옵시디언(Obsidian)에 메모를 옮겨 두려면 손이 많이 갑니다. 속성을 달고, 링크를 걸고, 표까지 만들어야 합니다. obsidian-skills는 옵시디언 대표 스테프 앙고(Steph Ango)가 공개한 스킬 묶음입니다. 클로드 같은 AI가 옵시디언 노트·Base 표·캔버스 파일을 규칙에 맞게 쓰도록 가르칩니다. 스킬은 무료지만 쓸 때마다 클로드 사용량이 듭니다. 2026-10-23에 독서 메모를 볼트로 정리하는 같은 요청을 스킬 없이 2번, 스킬을 넣고 2번 직접 실행한 기록입니다.

세 줄 요약
  1. 책 6권 독서 메모를 붙여 넣은 요청 하나로 책 노트 6개, 별점 4점 이상만 거르는 Base 표, 책 관계 캔버스가 1분 안팎에 나왔습니다. 4번 모두 같았습니다.
  2. 스킬을 넣으면 이름을 말하지 않아도 2번 모두 스킬 3개를 먼저 읽었습니다. 그런데 결과는 스킬 없이도 거의 같았습니다. 7점 기준으로 스킬 없이 7·7점, 있이 6·6점이었고, 깎인 1점은 읽는 중인 책의 빈 별점·날짜 속성을 아예 뺀 것입니다.
  3. 옵시디언 앱은 이 맥에 깔지 않아, Base 표와 캔버스는 공식 문서 기준 검사와 파일을 그대로 그린 간이 보기로 확인했습니다. 결과 볼트는 내려받아 내 옵시디언에서 바로 열어 볼 수 있습니다.

결과부터 보기: 메모 한 장이 노트·표·관계도로

요청은 “메모를 책마다 노트로, 관련 책끼리 링크, 인상 깊은 문장 강조, 독서 목록 Base(별점 4점 이상 표 보기와 전체 카드 보기, 다 읽은 지 며칠인지), 책 관계 캔버스”였습니다.

같은 요청을 스킬 없이·옵시디언 스킬로 보낸 1번째 결과 · Claude Code · Sonnet 5.5 · 생각 깊이 중간

직접 눌러 보기: 스킬 있이 1번째 결과, 스킬 없이 1번째 결과. 옵시디언 앱 화면이 아니라, 클로드가 만든 파일을 그대로 읽어 그린 간이 보기입니다. 노트 이름, Base 표, 캔버스 칸을 눌러 바꿔 볼 수 있습니다.

직접 실행 확인한 날짜 2026-10-23

실행 환경
macOS 26.1 · Claude Code 2.1.299 · Sonnet 5.5 · 생각 깊이 중간 (4번 모두 같은 설정) · obsidian 플러그인 1.0.1 · 옵시디언 앱으로는 열어 보지 않음
설치 난이도
클로드 코드에서 명령 두 줄, 또는 볼트의 .claude 폴더에 복사
비용
스킬 무료. 이번 정리 한 번에 API 단가로 0.28~0.39달러어치
라이선스
MIT · kepano/obsidian-skills(별 49,954개, 2026-10-23 기준)

obsidian-skills에 들어 있는 것

플러그인 이름은 obsidian이고, 스킬 6개만 들어 있습니다. 에이전트·훅·MCP 서버는 없습니다. claude plugin details로 구성을 확인했습니다.

터미널에 claude plugin details obsidian@obsidian-skills 결과가 나온 화면, 스킬 6개와 차지하는 토큰 표
obsidian 플러그인 구성: 스킬 6개, 깔아 두면 대화마다 약 400토큰
스킬하는 일이럴 때 불림
obsidian-markdown속성(맨 위 YAML), [[위키링크]], 콜아웃(> [!quote]), 임베드 같은 옵시디언식 마크다운 쓰기.md 노트를 만들거나 고칠 때
obsidian-basesBase 파일(.base)의 필터·공식·보기(표·카드·목록·지도)와 요약 쓰는 법, 함수 목록노트를 표처럼 모아 보는 화면을 만들 때
json-canvas캔버스 파일(.canvas)의 노드·연결선·그룹 규칙, id 겹침·끊긴 연결선 검사마인드맵·관계도·흐름도를 만들 때
obsidian-cli켜져 있는 옵시디언 앱을 명령어로 다루기(노트 읽기·검색·속성 바꾸기, 플러그인 개발 때 새로고침·오류 보기)내 볼트를 직접 검색·수정할 때. 앱이 켜져 있어야 함
defuddle웹페이지에서 광고·메뉴를 걷어 내고 본문만 마크다운으로 뽑기웹 글을 노트로 저장할 때. 별도 프로그램 설치 필요
knap틀(템플릿)에 JSON·CSV 데이터를 넣어 노트를 한꺼번에 만들기표 데이터로 노트 수십 개를 찍어 낼 때. 별도 프로그램 설치 필요

깔아 두기만 하면 대화마다 약 400토큰을 쓰고, 스킬이 불릴 때 Base 스킬은 약 3,200토큰, 캔버스 스킬은 약 1,800토큰을 더 읽습니다(도구 추정값). defuddle과 knap은 컴퓨터 전체에 프로그램을 까는 명령(npm install -g)을 안내해서, 이번 실험에서는 그 명령을 막고 돌렸습니다.

따라 해 보기: 요청문과 실습 재료

메모 파일(memo.txt) 하나만 든 빈 폴더에서 클로드 코드를 열고 보낸 요청입니다. 스킬 이름은 넣지 않았습니다.

memo.txt에 있는 독서 메모를 옵시디언 볼트로 정리해 줘. 책마다 노트 한 개씩 만들고(저자·별점·읽은 날짜·상태·태그를 속성으로), 관련 있는 책끼리는 서로 링크해 줘. 인상 깊은 문장은 눈에 띄게 표시해 줘. 그리고 독서 목록을 보는 Base 파일 하나(별점 4점 이상만 표로 보는 보기, 전체를 카드로 보는 보기, 다 읽은 지 며칠 지났는지 보여 주는 칸 포함)와, 책들 사이 관계를 한눈에 보는 캔버스 파일 하나도 만들어 줘. 파일은 이 폴더 안에만 만들어.

좋은 답이라면 책/ 폴더에 노트 6개와 .base, .canvas 파일이 하나씩 생기고, 읽는 중인 총균쇠처럼 메모에 없는 값은 지어내지 않고 비워 둡니다. 실습 재료(zip)에는 메모 파일, 요청문, 채점 기준, 스킬 있이 1번째 결과 볼트를 넣었습니다. 압축을 풀고 결과-볼트 폴더를 옵시디언에서 “폴더를 볼트로 열기”로 열면 됩니다.

1단계. 옵시디언 스킬 설치하기 (약 1분)

이 단계에서는 클로드 코드에 obsidian 플러그인을 넣습니다. 클로드 코드 대화창에서 두 줄을 차례로 실행합니다(저장소 안내 기준).

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

이렇게 나오면 성공 작업 폴더에서 같은 일을 터미널 명령으로 했더니 ✔ Successfully added marketplace: obsidian-skills, 이어서 ✔ Successfully installed plugin: obsidian@obsidian-skills가 나왔습니다. claude plugin details obsidian@obsidian-skills의 첫 줄은 obsidian 1.0.1입니다.

  • /plugin 명령이 없다고 나오면: claude --version으로 버전을 확인하고 클로드 코드를 최신으로 올립니다.
  • 내 볼트에서만 쓰려면: 저장소의 skills 폴더 안 내용을 볼트 맨 위 .claude/skills/에 복사합니다. 이번 비교 실험은 이 방식으로 넣었습니다.
  • 코덱스는 skills/ 폴더를 ~/.codex/skills에 복사하고, 다른 도구는 npx skills add https://github.com/kepano/obsidian-skills로 넣습니다(저장소 안내 기준, 이번에는 써 보지 않음). 같은 스킬을 여러 도구에서 쓰는 이야기는 클로드 스킬, 챗GPT·커서에서 쓰려면에 정리했습니다.
  • 필요 없어지면 /plugin uninstall obsidian@obsidian-skills로 지웁니다.

2단계. 같은 요청을 스킬 없이·있이 보내기 (약 1분)

이 단계에서는 위 요청을 스킬 없이 2번, 스킬을 넣고 2번 보냈습니다. 채점 기준은 실행 전에 옵시디언 공식 도움말과 JSON Canvas 1.0 명세에서 7가지로 뽑아 고정했고, 파일을 파이썬으로 읽어 검사했습니다.

  1. 책 노트 6개에 속성 5가지(저자·별점·읽은 날짜·상태·태그)가 다 있다
  2. 별점은 숫자, 읽은 날짜는 YYYY-MM-DD 형식이다
  3. 위키링크가 끊긴 곳이 없다
  4. 인상 깊은 문장이 콜아웃 문법으로 표시돼 있다
  5. Base가 정해진 구역만 쓰고, 표·카드 보기와 별점 4점 이상 필터를 갖췄다
  6. 경과 일수 공식이 있고, 보기에서 쓰는 공식이 모두 정의돼 있다
  7. 캔버스가 필수 칸·고유 id·이어진 연결선을 갖췄다
조건스킬이 불렸나점수 1·2(7점 만점)걸린 시간비용 1·2(달러)
스킬 없이–7 · 71분이 채 안 걸림(2번 모두)0.28 · 0.30
옵시디언 스킬 넣고 같은 요청2번 모두 저절로(3개씩)6 · 61분 남짓 · 1분 안쪽0.39 · 0.32

4번 모두 노트 6개, Base 1개, 캔버스 1개를 만들었고, 끊긴 링크·끊긴 연결선·문법 오류는 하나도 없었습니다. 인상 깊은 문장은 4번 모두 > [!quote] 콜아웃 안에 ==형광펜==으로 표시했습니다.

깎인 1점: 빈 속성을 넣을까 뺄까

스킬을 넣은 2번은 읽는 중인 총균쇠 노트에서 별점과 읽은 날짜 속성을 아예 뺐습니다. 스킬 없이 보낸 2번은 같은 자리를 빈 칸으로 남겼습니다. 둘 다 값을 지어내지는 않았고, Base 표에서는 어느 쪽이든 빈칸으로 보입니다. 다만 나중에 다 읽고 별점을 채울 때는 속성 칸이 미리 있는 쪽이 편해서, 채점 기준대로 1점을 뺐습니다.

스킬이 한 일: 쓰기 전에 규칙부터 읽기

스킬을 넣은 2번은 메모를 읽은 직후 노트·Base·캔버스 스킬을 차례로 불렀습니다. 그만큼 대화가 길어져 턴이 10~11번에서 17~20번으로 늘었고, 비용도 조금 더 들었습니다.

실행 기록 · <작업 폴더>/runs/with-1.jsonl · 클로드가 부른 도구 순서(앞부분)

Bash  ls -la && cat memo.txt
Skill obsidian-markdown
Skill obsidian-bases
Skill json-canvas
Bash  mkdir -p 책 && python3 -I - <<'EOF' …
…

스킬 없이 보낸 쪽도 Base 문법을 정확히 알고 있었습니다. 4번 모두 필터에 file.inFolder("책"), 경과 일수에 (today() - date(finished)).days 같은 같은 꼴의 공식을 썼습니다. 이번 요청에서는 소넷 5.5가 스킬 없이도 같은 꼴로 썼습니다. 이 정도 일에서는 스킬이 더해 준 것이 거의 없었습니다.

앱에서 열기 전에 알아 둘 것: 경과 일수 공식

경과 일수 공식은 4번 모두 두 날짜를 뺀 뒤 .days를 붙였습니다. 스킬 설명은 “날짜를 빼면 기간(Duration)이 나오니 .days로 일수를 꺼내라”고 안내합니다. 공식 도움말 문법 페이지는 “두 날짜를 빼면 밀리초 차이가 나온다”고만 적고 있습니다. 옵시디언 앱으로 열어 보지 않아서 어느 쪽이 맞는지는 확인하지 못했습니다. 내려받은 볼트에서 이 칸이 비어 보이면 클로드에게 “다 읽은 지 며칠 칸이 비어 있어, 고쳐 줘”라고 요청합니다.

3단계. 내 옵시디언에서 열어 보기 (약 1분)

이 단계에서는 만든 볼트를 옵시디언에서 엽니다. 옵시디언 첫 화면에서 “폴더를 볼트로 열기(Open folder as vault)”를 누르고 클로드가 작업한 폴더를 고릅니다.

이렇게 나오면 성공 공식 도움말 기준으로 Base 하나에 표·카드 같은 보기를 여러 개 둘 수 있어서, 독서 목록.base를 열면 “별점 4점 이상” 표와 “전체 카드” 보기를 골라 볼 수 있어야 합니다. 이 화면은 이번에 직접 확인하지 않았습니다.

  • Base 파일이 열리지 않으면: Bases는 옵시디언 1.9.0에 들어온 핵심 플러그인(core plugin)입니다. 앱이 그보다 오래됐으면 먼저 업데이트하고, 설정 > 핵심 플러그인에서 Bases가 켜져 있는지 봅니다.
  • 켜 둔 옵시디언을 클로드가 직접 다루게 하려면: obsidian-cli 스킬이 옵시디언 명령줄 도구(Obsidian CLI)를 씁니다. 앱이 켜져 있어야 하고, 이번에는 앱이 없어 써 보지 않았습니다.

이런 사람에게 권합니다

  • ✅ 옵시디언 볼트에서 클로드 코드·코덱스를 자주 돌리는 사람. 노트를 만들 때마다 속성·링크·콜아웃 규칙을 먼저 읽고 시작합니다. 깔아 두는 부담도 대화마다 약 400토큰으로 작습니다.
  • ✅ 켜 둔 옵시디언을 명령으로 검색·수정하거나, 웹 글을 노트로 저장하려는 사람. obsidian-cli·defuddle 같은 스킬은 쓰는 법 자체를 알려 줍니다(SKILL.md 기준, 이번에는 써 보지 않음).
  • ❌ 메모 몇 개를 한 번 노트로 옮기려는 사람. 이번 실험에서는 스킬 없이도 7점 만점이 나왔고, 비용은 조금 덜 들었습니다.

한계와 주의할 점

  • 독서 메모 하나, 소넷 5.5로 조건마다 2번씩입니다. 더 약한 모델이나 다른 AI 도구에서는 결과가 다를 수 있습니다.
  • defuddle·knap 스킬은 프로그램을 컴퓨터 전체에 깔라고 안내합니다. 회사 컴퓨터라면 설치 허락을 먼저 받습니다.

대안

방법다른 점이럴 때 고르세요
obsidian-skills(이 글)옵시디언 대표가 만든 스킬 6개. 노트·Base·캔버스 규칙과 앱 명령줄 도구 사용법볼트에서 AI를 자주 쓸 때
스킬 없이 클로드 코드에 요청이번 요청은 스킬 없이도 같은 결과(소넷 5.5)한 번 정리하고 끝낼 때

스킬이 무엇인지는 클로드 스킬이란?, 다른 인기 스킬은 클로드 스킬·플러그인 디렉터리 글에 정리했습니다.

자주 묻는 질문

옵시디언 AI, 돈이 드나요?

옵시디언과 obsidian-skills는 무료이고, 클로드 요금제의 사용량을 씁니다. 이번 독서 메모 정리 한 번은 API 단가로 0.28~0.39달러어치였습니다.

옵시디언을 안 깔아도 되나요?

파일을 만드는 것까지는 옵시디언 없이 됐습니다. 노트·Base·캔버스는 모두 글자 파일이라 클로드가 폴더에 바로 씁니다. 만든 결과를 표와 그림으로 보려면 옵시디언이 필요합니다.

클로드 앱(채팅)에서도 쓸 수 있나요?

저장소는 클로드 코드·코덱스·오픈코드 설치법을 안내합니다. 클로드 앱 채팅에서 쓰는 방법은 저장소에 따로 적혀 있지 않아, 이번에는 클로드 코드에서만 써 봤습니다.

Base가 뭔가요? 데이터뷰(Dataview)와 다른가요?

Base는 옵시디언에 기본으로 들어온 기능으로, 노트 속성을 표·카드로 모아 보는 .base 파일입니다. 데이터뷰는 커뮤니티 플러그인이고 노트 안에 코드 블록으로 씁니다. 이번 4번은 모두 Base 파일로 만들었고 데이터뷰는 쓰지 않았습니다.

출처

kepano/obsidian-skills 저장소(README·SKILL.md, 1.0.1), 옵시디언 도움말: Bases 문법, JSON Canvas 1.0 명세 (모두 2026-10-23 확인)