Obsidian Skills (kepano)

Name: Obsidian Skills (kepano) (Claude Skill)
Author: kepano

왜 쓰나요

핵심 기능

실제 Obsidian 사용자가 따르는 Markdown 규칙
Bases (Obsidian 1.10+) — 스키마 정의 컬렉션
JSON Canvas — 노트의 시각적 지도
배치 작업을 위한 Obsidian CLI 패턴
Property/frontmatter 관용어

라이브 데모

실제 사용 모습

준비됨

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: Obsidian Skills (kepano)

일관된 properties로 지저분한 Obsidian vault 정리

👤 오랜 Obsidian 사용자 ⏱ ~60 min intermediate

언제 쓸까: 수년간의 노트 — 일관성 없는 태그, properties, 파일 명명.

사전 조건

Obsidian vault 경로 — skill에 경로 지정

흐름

감사

Use obsidian-skills. Audit /vault — list inconsistencies in properties, dead links, orphan notes.✓ 복사됨

→ 문제 목록
표준화

Migrate tag: to YAML tags: properties consistently.✓ 복사됨

→ 영향받는 노트의 diff
검증

Re-audit. Confirm orphans have homes and properties are consistent.✓ 복사됨

→ 깔끔한 감사 결과

결과: 검색과 링크가 깔끔하게 작동하는 vault.

함정

대량 편집이 플러그인을 깸 — 백업 복사본에서 먼저 테스트; skill이 이를 제안

함께 쓰기: filesystem

노트 폴더를 Obsidian Base로 변환

👤 프로젝트 추적을 위해 Bases를 적용하는 사용자 ⏱ ~45 min intermediate

언제 쓸까: 프로젝트 노트 위에 타입이 지정된 뷰를 원할 때.

흐름

스키마

Look at /vault/projects. Propose a Base schema — properties, types, defaults.✓ 복사됨

→ 스키마 사양
마이그레이션

Update each project note to conform. Backfill defaults where missing.✓ 복사됨

→ 노트 준수 완료; Base 뷰 작동

결과: 작동하는 Base; 프로젝트를 정렬, 필터, 그룹화할 수 있음.

함정

Property 타입 불일치 — Skill이 타입을 검증함 — Base가 깔끔하게 로드되기 전에 표시된 노트 수정

주제에 관련된 노트의 JSON Canvas 생성

👤 연구자 / 작가 ⏱ ~30 min intermediate

언제 쓸까: 주제에 대해 노트들이 어떻게 연결되는지 시각적 지도를 원할 때.

흐름

클러스터링

Find notes related to 'distributed systems'. Cluster by sub-topic.✓ 복사됨

→ 클러스터 목록
렌더링

Render as a JSON Canvas with grouped boxes and edges for backlinks.✓ 복사됨

→ .canvas 파일 작성됨

결과: Obsidian에서 열어 시각적으로 탐색할 수 있는 canvas.

함정

레이아웃 겹침 — Skill에 기본 자동 레이아웃 포함; Obsidian에서 정제

조합

다른 MCP와 조합해 10배 효율

obsidian-skills-kepano + filesystem

Vault 편집을 위한 직접 파일 접근

obsidian-skills-kepano + claude-obsidian-skill

Daniel의 Claude×Obsidian skill과 레이어링

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
audit_vault	path	주기적 정리	vault 크기에 따른 token
design_base	folder	Bases 적용	token
render_canvas	note_set, layout?	시각적 지도	token
obsidian_cli	command	CLI를 통한 배치 작업	출력 파싱을 위한 token

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 큰 vault에서 높음; 폴더로 범위를 제한하면 도움됨
금액: 무료
팁: 첫 실행 시 전체 vault가 아닌 폴더별 감사

보안

권한, 시크릿, 파급범위

최소 스코프: vault에 읽기/쓰기

자격 증명 저장: 없음

데이터 외부 송신: 없음

개인 노트 — 클라우드 에이전트와의 채팅에서 무엇을 붙여넣는지 주의

문제 해결

자주 발생하는 오류와 해결

Bases 스키마 거부됨

Property 타입은 모든 노트에서 일치해야 함 — skill이 위반자를 표시

Canvas 겹침

클러스터 크기를 줄이거나 수동 정리를 위해 Obsidian에서 열기

CLI 명령어를 찾을 수 없음

Obsidian CLI를 별도로 설치; skill은 PATH에 있다고 가정

대안