← 보드로 돌아가기

kepano/obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

GitHub에서 열기 ↗ agentsagentskillsbasesclaudeclawdbotclicodexdefuddlehermesjsoncanvasmarkdownmdobsidianopenclawopencodeskills
40,619
GitHub 스타
2,885
포크
—
언어
MIT
라이선스
2026.06.08
최근 푸시
2026.06.03
별표한 날

AI 분석

설치 난이도: 쉬움
큐레이터 노트
Obsidian을 적극적으로 사용하고 AI 에이전트(Claude Code, Codex 등)로 볼트를 자동화하려는 사용자에게 적극 추천합니다. 특히 위키링크, Bases, Canvas 등 Obsidian 고유 기능을 에이전트가 다루게 하려면 필수적인 도구입니다.

강점

  • Obsidian의 고유 기능(위키링크, 콜아웃, Bases 등)을 에이전트가 직접 다룰 수 있도록 지원하여 Obsidian 사용자에게 매우 유용함
  • Agent Skills 표준을 따르므로 Claude Code, Codex, Open Code 등 다양한 에이전트에서 호환되어 범용성이 높음
  • 설치 방법이 다양하고(마켓플레이스, npx, 수동) 각 에이전트별로 상세히 안내되어 있어 접근성이 좋음

약점

  • README에 각 스킬의 구체적인 사용 예시나 명령어가 없어 실제 사용 방법을 파악하기 어려움
  • 스킬의 기능이 Obsidian에 특화되어 있어 Obsidian을 사용하지 않는 개발자에게는 의미가 없음
  • Defuddle 스킬을 제외하면 대부분 Obsidian 내부 형식에 국한되어 있어 일반적인 마크다운 처리에는 부적합함

주의사항

  • OpenCode 설치 시 전체 저장소를 클론해야 하며, skills 폴더만 복사하면 안 됨
  • 스킬을 사용하려면 각 에이전트가 Agent Skills 명세를 지원해야 함
  • Obsidian CLI 스킬은 Obsidian CLI가 설치되어 있어야 정상 작동함

시작 가이드

  • Obsidian 볼트에 스킬을 설치하고 각 스킬의 SKILL.md를 읽어 구체적인 사용법을 숙지하세요
  • Claude Code나 Codex에서 실제로 스킬을 호출하여 마크다운 파일 생성, Bases 편집 등을 테스트해보세요
  • Defuddle 스킬을 활용하여 웹 페이지를 Obsidian 노트로 자동 변환하는 워크플로우를 구축해보세요

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Obsidian용 에이전트 스킬

이 스킬들은 Agent Skills 명세를 따르므로, Claude Code, Codex, Open Code 등 스킬 호환 에이전트에서 사용할 수 있습니다.

설치

마켓플레이스

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

npx skills

npx skills add [email protected]:kepano/obsidian-skills.git

SSH 대신 HTTPS를 선호하는 경우:

npx skills add https://github.com/kepano/obsidian-skills

수동 설치

Claude Code

이 저장소의 내용을 Obsidian 볼트(또는 Claude Code와 함께 사용하는 폴더)의 루트에 있는 /.claude 폴더에 추가하세요. 자세한 내용은 공식 Claude Skills 문서를 참조하세요.

Codex

skills/ 디렉토리를 Codex 스킬 경로(일반적으로 ~/.codex/skills)에 복사하세요. 표준 스킬 형식은 Agent Skills 명세를 참조하세요.

OpenCode

전체 저장소를 OpenCode 스킬 디렉토리(~/.opencode/skills/)에 클론하세요:

git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

내부 skills/ 폴더만 복사하지 말고 전체 저장소를 클론하여 디렉토리 구조가 ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md가 되도록 하세요.

OpenCode는 ~/.opencode/skills/ 아래의 모든 SKILL.md 파일을 자동으로 발견합니다. opencode.json이나 다른 설정 파일을 변경할 필요가 없습니다. 스킬은 OpenCode를 다시 시작한 후 사용할 수 있습니다.

스킬

스킬 설명
obsidian-markdown 위키링크, 임베드, 콜아웃, 속성 및 기타 Obsidian特有 구문을 포함한 Obsidian Flavored Markdown (.md) 생성 및 편집
obsidian-bases 뷰, 필터, 수식, 요약을 포함한 Obsidian Bases (.base) 생성 및 편집
json-canvas 노드, 엣지, 그룹, 연결을 포함한 JSON Canvas 파일 (.canvas) 생성 및 편집
obsidian-cli Obsidian CLI를 통해 Obsidian 볼트와 상호작용 (플러그인 및 테마 개발 포함)
defuddle Defuddle을 사용하여 웹 페이지에서 깔끔한 마크다운 추출, 불필요한 내용 제거로 토큰 절약

원본 저장소: kepano/obsidian-skills

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.