일하는 ai

3_옵시디안Skill활용

8 min read

-

Obsidian/images/obsidian-03-skill-활용-diagram.svg

Repository Info

Repository: kepano/obsidian-skills: Agent skills for Obsidian Author: kepano

1. Executive Summary

Executive Summary

1) 프로젝트 소개

Obsidian 노트 앱을 위한 에이전트 스킬 세트로, Claude Code나 Codex CLI 같은 AI 에이전트와 호환되어 Markdown, Base, Canvas 등의 Obsidian 파일을 생성/편집할 수 있습니다.

2) 주요 기능

  1. Obsidian Flavored Markdown 지원: Obsidian 전용 마크다운 형식(.md)을 생성/편집. 링크, 태그, 임베드 등 고급 기능을 포함한 노트를 자동화하여 지식 관리 효율화.
  2. Obsidian Bases 생성: .base 파일 형식으로 데이터베이스-like 구조 생성. 노트 간 관계를 정의하고 쿼리 가능한 기반 구조를 빠르게 구축.
  3. JSON Canvas 지원: .canvas 파일로 시각적 캔버스 다이어그램 생성. 노트와 아이디어를 노드/엣지로 연결한 인터랙티브 다이어그램 자동화.
  4. Claude Code 통합: Obsidian 볼트 내 /.claude 폴더에 스킬 배치로 Claude와 즉시 연동. AI가 Obsidian 워크플로우를 직접 제어.
  5. Codex CLI 호환: ~/.codex/skills 경로에 복사로 Codex 사용. 표준 Agent Skills 스펙 준수로 범용 AI 에이전트 지원.

3) 기술 스택 및 의존성

Agent Skills 스펙 기반(스키마 정의 YAML/JSON), Obsidian 파일 형식(.md, .base, .canvas), Claude Code/Codex CLI 호환. 별도 의존성 없음(플러그인/CLI 설치만 필요).

4) 타겟 사용자 및 사용 사례

Obsidian 사용자 중 AI 에이전트(Claude, Codex) 활용자. 지식 그래프 자동화, 노트 생성, 캔버스 빌드 등 PKM(Personal Knowledge Management) 워크플로우 자동화.

2. What is This Tool

도구 상세 설명

이 프로젝트는 Obsidian 노트 앱 사용자들이 AI 에이전트를 통해 노트 생성/편집을 자동화하는 문제를 해결합니다. 기존 Obsidian 플러그인이나 수동 편집과 달리, Agent Skills 스펙을 준수해 Claude Code나 Codex CLI 같은 범용 AI와 호환되어 별도 개발 없이 즉시 사용 가능합니다.

혁신성은 표준화된 스킬 형식으로 여러 AI 에이전트 간 이식성을 제공하며, Obsidian 고유 형식(OFM, Bases, Canvas)을 직접 지원해 AI가 네이티브처럼 동작합니다. 기존 솔루션(예: Obsidian AI 플러그인)은 특정 AI에 종속되거나 제한적 기능만 지원하나, 이는 스펙 기반으로 확장성과 호환성을 강조합니다.

핵심 원리는 Agent Skills 스펙을 따르는 YAML/JSON 스키마로 스킬 정의: 입력 파라미터(파일 경로, 내용), 출력(생성/편집 결과)을 명시합니다. AI 에이전트가 스킬을 호출하면 Obsidian 볼트 내 파일을 표준 형식으로 처리하며, Claude Code는 /.claude 폴더 스캔, Codex는 ~/.codex/skills 경로 로딩으로 작동합니다.

아키텍처는 간단: 루트에 skills/ 디렉토리(각 스킬 YAML 파일), .claude-plugin/ (Claude 전용 메타), README/LICENSE. 메인 컴포넌트는 skills/ 내 개별 스킬 파일(예: create-md.skill.yaml)로, 스키마(inputSchema, outputSchema)와 구현 로직(파일 I/O)을 포함합니다. 플러그인 설치 시 marketplace나 수동 복사로 배포됩니다.

3. Usage Guide

활용법 가이드

설치 단계

Marketplace (Obsidian 플러그인):

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

Claude Code (수동): Obsidian 볼트 루트에 /.claude 폴더 생성 후 repo 내용 복사. Codex CLI (수동): ~/.codex/skills에 skills/ 디렉토리 복사.

기본 사용법

AI 에이전트(Claude/Codex)에 스킬 호출: obsidian-create-md path/to/note.md "내용". 예: `obsidian-create-md daily/2026-01-12.md ”# Daily Note

  • Task1”` → 해당 경로에 Markdown 파일 생성.

고급 옵션 및 커스터마이징

  • Bases: obsidian-create-base path/to/base.base schema.json으로 데이터베이스 생성.
  • Canvas: obsidian-edit-canvas my.canvas.json nodes.json으로 노드 추가/편집.
  • YAML 스킬 파일 수정으로 파라미터 커스텀(예: inputSchema에 파일 형식 제한).

실전 사용 사례

  1. 일일 노트 자동화: obsidian-create-md daily/$(date +%Y-%m-%d).md "오늘 할 일: 이전 노트" → 매일 링크된 노트 생성, 결과: 연결된 지식 그래프.
  2. 캔버스 아이디어 맵: obsidian-create-canvas idea.canvas.json [{"id":"node1","text":"AI"}] → 시각 다이어그램 생성, 결과: 노드 기반 브레인스토밍.
  3. 베이스 데이터베이스: obsidian-create-base tasks.base.json {"fields":["status","priority"]} → 태스크 DB 생성, 결과: 쿼리 가능한 노트 시스템.

제한사항 및 문제 해결

  • Obsidian 앱 실행 필요(파일 접근 제한). 볼트 경로 명시.
  • AI 파라미터 오류 시 로그 확인(Codex: codex --debug). 권한 문제: 볼트 폴더 읽기/쓰기 확인.

4. Application Ideas

적용 아이디어

1) 즉시 실행 항목

  • Obsidian 볼트에 /.claude 폴더 생성 후 repo 클론하여 Claude Code 연동 테스트.
  • Codex CLI 설치 후 skills/ 복사하고 codex obsidian-create-md test.md "Hello" 실행.
  • README 스킬 목록 검토 후 하나(예: Canvas) 실험 노트 생성.

2) 기존 워크플로우 통합

Obsidian PKM 루틴에 AI 자동화 삽입: 매일 노트 생성 스크립트화, 캔버스 업데이트 GitHub Actions 연동.

3) 다른 도구 조합 아이디어

  • Claude + Obsidian: AI 채팅으로 노트 직접 편집.
  • Codex + Git: PR 생성 시 자동 캔버스 업데이트.
  • Logseq + 이 스킬: 유사 PKM 앱 간 파일 변환.

4) 학습 로드맵

전제 지식: Obsidian 기본(볼트, Markdown), YAML/JSON 스키마. 관련 자료: Agent Skills Spec, Obsidian Docs, Claude/Codex 공식 가이드. 단계: 1) 스펙 읽기(1h), 2) 설치 테스트(30m), 3) 스킬 커스텀(2h), 4) 워크플로우 빌드.

5. Original README

Skip to content

obsidian-skills Public

Agent skills for Obsidian

License

MIT license

Open in github.dev Open in a new github.dev tab Open in codespace

kepano/obsidian-skills

Add file

Folders and files

NameName

Last commit message

Last commit date

Latest commit

Merge pull request #27 from shreyas-makes/agent-skills-compat

4540df8 ·

History

20 Commits

.claude-plugin

.claude-plugin

plugin info

skills

skills

Align skills with Agent Skills spec and Codex

LICENSE

LICENSE

license

README.md

README.md

Align skills with Agent Skills spec and Codex

Agent Skills for use with Obsidian.

These skills follow the Agent Skills specification so they can be used by any skills-compatible agent, including Claude Code and Codex CLI.

Installation

Marketplace

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

Manually

Claude Code

Add the contents of this repo to a /.claude folder in the root of your Obsidian vault (or whichever folder you’re using with Claude Code). See more in the official Claude Skills documentation.

Codex CLI

Copy the skills/ directory into your Codex skills path (typically ~/.codex/skills). See the Agent Skills specification for the standard skill format.

Skills

Releases

No releases published

Packages

No packages published

6. My Notes

메모

관련 링크

Clipped: 2026-01-13T20:46:35+09:00

그래프 뷰

백링크