Obsidian Skills (kepano)

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

왜 쓰나요

핵심 기능

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

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-skills-kepano",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-skills-kepano": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/kepano/obsidian-skills",
          "~/.claude/skills/obsidian-kepano"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add obsidian-skills-kepano -- git clone https://github.com/kepano/obsidian-skills ~/.claude/skills/obsidian-kepano

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: 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에 있다고 가정

대안