Obsidian

• AI 에이전트가 이름이나 내용으로 노트를 검색하고 관련 스니펫을 표시하기를 원할 때.
• Obsidian의 URI 핸들러를 통해 특정 폴더에 선택적으로 미리 채워진 내용과 함께 새 노트를 생성해야 할 때.
• 노트를 안전하게 이름 변경하거나 이동해야 할 때 — obsidian-cli move는 볼트 전체의 모든 [[wikilinks]]를 업데이트하며, 일반 mv 명령어를 사용하면 링크가 깨집니다.
• Obsidian을 직접 조작하지 않고 볼트 유지 관리를 자동화하고 싶을 때 (오래된 노트 삭제, 항목 일괄 생성 등).

• Obsidian 데스크톱 앱을 사용하고 있지 않은 경우 — obsidian-cli는 Obsidian이 설치되어 있고 볼트 레지스트리(obsidian.json)가 존재해야 합니다.
• 캔버스 파일(.canvas) 또는 플러그인 설정(.obsidian/)을 다루어야 하는 경우 — 해당 형식은 이 스킬에서 지원하지 않습니다.
• Linux 또는 Windows를 사용하는 경우 — obsidian-cli는 Homebrew를 통해 설치되며, 참조하는 볼트 레지스트리 경로는 macOS 전용입니다(~/Library/Application Support/obsidian/).

obsidian-cli search를 사용하여 파일명으로 노트를 찾거나, obsidian-cli search-content를 사용하여 노트 내용을 검색하면 일치하는 스니펫과 줄 번호가 반환됩니다.

obsidian-cli move는 노트의 이름을 바꾸거나 위치를 변경하는 동시에, 볼트 전체에서 해당 노트를 참조하는 모든 [[wikilinks]] 및 일반 Markdown 링크를 자동으로 업데이트합니다 — 이는 단순한 파일 시스템 이름 바꾸기에 비해 결정적인 장점입니다.

obsidian-cli create를 사용하여 선택적으로 미리 채워진 내용과 함께 모든 볼트 경로에 노트를 생성하세요. 이 명령어는 Obsidian의 URI 핸들러를 통해 라우팅되어 새 파일이 올바르게 등록되도록 합니다.

이 스킬은 경로를 하드코딩하는 대신 Obsidian의 자체 obsidian.json을 읽어 활성 볼트를 찾으며, 다중 볼트 설정(iCloud, 업무/개인 등)을 올바르게 처리합니다.

간단한 읽기나 편집 작업의 경우, 스킬이 .md 파일을 직접 열 수 있습니다 — Obsidian은 파일 시스템 변경 사항을 자동으로 감지하므로, 직접 편집이 CLI 명령어에 대한 빠르고 유효한 대안이 됩니다.

에이전트에게 특정 프로젝트나 주제와 관련된 모든 노트를 찾아달라고 요청하세요. search-content를 사용하여 관련 스니펫과 줄 참조를 반환하므로, 수백 개의 노트에 흩어져 있는 정보를 빠르게 찾을 수 있습니다.

회의 녹취록, 웹 리서치, 또는 작업 목록을 입력하면 에이전트가 obsidian-cli create를 사용하여 프론트매터와 내용을 포함한 구조화된 마크다운 노트를 올바른 Obsidian 볼트 폴더에 생성합니다.

끊어진 링크를 일일이 찾아 수동으로 수정할 필요 없이 노트 계층 구조의 이름을 바꾸거나 재구성하세요 — obsidian-cli move는 vault 전체에 걸쳐 모든 내부 참조를 그대로 유지합니다.

에이전트가 오래되거나 중복된 노트를 검색하여 obsidian-cli delete로 삭제하도록 하여, 직접 폴더를 탐색할 필요 없이 보관함을 깔끔하게 유지하세요.