←목록으로
📝스킬

옵시디언 스킬 완벽 정리 — CEO가 만든 Claude Code 스킬 5종

옵시디언 CEO가 직접 만든 AI 에이전트용 스킬 5종으로 위키링크, 콜아웃, Bases, Canvas를 완벽하게 다루는 방법

↗ 원본 링크
#옵시디언#Claude Code#Agent Skills#마크다운#자동화

옵시디언 스킬이란?

obsidian-skills는 옵시디언 CEO Steph Ango가 직접 공개한 AI 에이전트용 스킬 모음입니다. Claude Code, Codex CLI 같은 AI 코딩 에이전트가 옵시디언 고유 문법을 정확히 이해하고 사용할 수 있게 도와줍니다.

5가지 스킬 구성

1. obsidian-markdown

위키링크, 콜아웃, 임베드 등 옵시디언 마크다운 문법을 가르칩니다.

markdown
[[Note Name]]              # 위키링크
[[Note#Heading]]           # 헤딩 링크
![[image.png|300]]         # 이미지 임베드
> [!warning] 제목          # 콜아웃

2. obsidian-bases

.base 파일로 노트를 데이터베이스처럼 관리하는 방법을 학습합니다.

yaml
filters:
  - tag: project
formulas:
  days_left: '(date(due_date) - today()).days'
views:
  - type: table

3. json-canvas

시각적 다이어그램을 위한 .canvas JSON 구조를 생성합니다.

4. obsidian-cli

터미널에서 옵시디언을 제어하는 명령어 사용법을 익힙니다.

bash
obsidian open "Note Name"
obsidian search "keyword"
obsidian bookmark add "Note Name"

5. agent-skill

Agent Skills 사양 자체를 가르쳐 새로운 스킬 작성법을 알려줍니다.

왜 중요한가?

AI는 일반 마크다운만 학습했기 때문에 옵시디언 고유 문법([[위키링크]], 콜아웃 등)을 제대로 쓰지 못합니다. 이 스킬을 사용하면:

▸✅ AI가 옵시디언 문법을 정확히 출력
▸✅ 반복 수정 없이 바로 사용 가능
▸✅ 토큰 절약 + 정확도 향상

설치 방법

Claude Code (VS Code)

bash
cd ~/.config/@modelcontextprotocol/server/agent-skills/skills/
git clone https://github.com/kepano/obsidian-skills

Codex CLI

bash
codex skills add https://github.com/kepano/obsidian-skills
codex skills list

수동 등록 (범용)

.clinerules 파일에 추가:

agent-skill:https://github.com/kepano/obsidian-skills/obsidian-markdown

실전 활용 예시

명령: "프로젝트 A 요약 노트를 만들어줘"

스킬 없을 때:

markdown
[프로젝트 A](project-a.md)  # 틀림

스킬 적용 후:

markdown
[[프로젝트 A]]  # 정답
![[project-diagram.canvas]]
> [!info] 상태
> 진행 중

마무리

옵시디언 CEO가 직접 만든 공식 레퍼런스이므로 신뢰도가 높고, Agent Skills 표준을 따라 확장성도 뛰어납니다. 옵시디언 + AI 자동화를 쓰는 분이라면 필수로 설치해 두세요.

저장소: github.com/kepano/obsidian-skills