Skill ★ 23.8k

Obsidian Skills

obsidian.md/cli → kepano/obsidian-skills →
#Obsidian#마크다운#노트#Canvas#지식관리

업데이트

💡

Obsidian 마크다운, Canvas, Base 등 고유 파일 형식을 Claude Code에서 직접 생성·편집할 수 있게 하는 에이전트 스킬 모음.

🔓
Obsidian 볼트 직접 조작 새로운 능력
설치 방법 · plugin marketplace
마켓플레이스 추가 후 설치 $ /plugin marketplace add kepano/obsidian-skills && /plugin install obsidian@obsidian-skills
NPX Skills $ npx skills add [email protected]:kepano/obsidian-skills.git

Obsidian CEO Steph Ango(@kepano)가 직접 개발·관리하는 스킬

왜 필요한가?

Obsidian은 위키링크([[]]), 캘아웃, 프로퍼티, Canvas, Base 등 표준 마크다운을 넘어서는 고유한 파일 형식을 사용합니다. 일반 마크다운만 아는 Claude Code로는 이런 Obsidian 고유 문법을 올바르게 생성하거나 편집하기 어렵습니다. Obsidian Skills를 설치하면 Claude Code가 Obsidian의 파일 형식과 문법을 이해하고, 볼트 내 콘텐츠를 직접 생성·편집할 수 있게 됩니다.

포함된 스킬

스킬설명
obsidian-markdown위키링크, 임베드, 캘아웃, 프로퍼티 등 Obsidian 마크다운 생성·편집
obsidian-bases데이터베이스 형태의 Base 파일 생성 — 뷰, 필터, 수식 지원
json-canvas노드와 엣지로 구성된 Canvas 파일(시각적 다이어그램) 생성·편집
obsidian-cliCLI를 통한 볼트 제어 — 플러그인/테마 개발, 검색, 자동화
defuddle웹 페이지에서 클린 마크다운 추출 — 토큰 사용량 절감

사전 요구 사항

obsidian-cli 스킬을 사용하려면 Obsidian CLI가 설치되어 있어야 합니다.

  1. Obsidian 최신 버전 설치
  2. Settings → General에서 Command line interface 활성화
  3. 안내에 따라 시스템 PATH에 등록 (macOS: /usr/local/bin/obsidian)

설치 후 터미널에서 obsidian 명령으로 볼트 검색, 노트 열기, 데일리 노트 추가 등을 수행할 수 있습니다. 자세한 내용은 Obsidian CLI 공식 문서를 참고하세요.

실제 사용 시나리오

  1. “회의록을 Obsidian 노트로 만들어줘” → 프로퍼티(날짜, 참석자, 태그) + 위키링크 포함된 노트 자동 생성
  2. “프로젝트 구조를 Canvas로 시각화해줘” → JSON Canvas 형식의 노드-엣지 다이어그램 생성
  3. “읽은 논문 목록을 Base로 정리해줘” → 필터·수식이 포함된 데이터베이스 파일 생성

알아두면 좋은 점

  • Agent Skills 스펙 준수 — Claude Code 외에 Codex CLI, OpenCode에서도 사용 가능
  • obsidian-markdown, obsidian-bases, json-canvas 스킬은 Obsidian CLI 없이도 파일 생성·편집 가능
  • obsidian-cli 스킬만 Obsidian CLI 설치가 필요
  • MIT 라이선스

자주 묻는 질문

Obsidian Skills는 무엇인가요?

Obsidian의 고유 파일 형식(위키링크, 캘아웃, 프로퍼티, Canvas, Base)을 Claude Code에서 직접 생성·편집할 수 있게 해주는 에이전트 스킬 모음입니다. Obsidian CEO Steph Ango(@kepano)가 직접 개발·관리합니다.

어떤 환경에서 동작하나요?

Claude Code에서 동작하며, Agent Skills 스펙을 준수해 Codex CLI와 OpenCode에서도 사용 가능합니다.

어떻게 설치하나요?

마켓플레이스를 추가한 뒤 설치합니다. `/plugin marketplace add kepano/obsidian-skills` 후 `/plugin install obsidian@obsidian-skills`. NPX Skills 방식으로도 설치 가능합니다.

어떤 스킬이 포함되어 있나요?

obsidian-markdown(위키링크·캘아웃·프로퍼티), obsidian-bases(데이터베이스 형태 Base 파일), json-canvas(Canvas 다이어그램), obsidian-cli(CLI 제어·자동화), defuddle(웹 페이지 → 클린 마크다운) 5개입니다.

Obsidian CLI는 꼭 필요한가요?

obsidian-cli 스킬에만 필요합니다. obsidian-markdown, obsidian-bases, json-canvas는 Obsidian CLI 없이도 파일 생성·편집이 가능합니다.

라이선스는 어떻게 되나요?

MIT 라이선스로 공개되어 있습니다.