Community라이팅 & 에디팅github.com

steipete/obsidian

Obsidian 볼트: 노트 검색/읽기/쓰기, 백링크, 베이스, 캔버스.

obsidian란 무엇인가요?

이 스킬은 로컬 Obsidian 볼트 작업을 위한 AI 비서의 능력을 제공합니다. Obsidian 볼트는 일반 마크다운 파일과 `.obsidian/` 설정 폴더로 구성된 폴더입니다. 공식 Obsidian CLI(`obsidian`)를 사용하여 노트 검색, 읽기, 생성, 수정, 이동 및 일일 노트 작업을 수행할 수 있습니다. 또한 베이스, 캔버스, 플러그인과 같은 Obsidian 고유 기능도 지원하며, 직접 파일 시스템 접근(`sed`, `rg`)과 `apply_patch`를 통한 정밀한 편집도 가능합니다. 사용자에게 안전한 워크플로를 위해 일괄 수정이나 숨겨진 설정 파일 편집을 피하고, 요청 시에만 UI를 열도록 설계되었습니다. CLI가 비활성화된 경우 설정을 활성화하는 방법도 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/obsidian

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

obsidian은(는) 무엇을 하나요?

로컬 Obsidian 볼트 작업에 사용하세요. Obsidian 볼트는 마크다운 파일과 .obsidian/ 설정이 있는 일반 폴더입니다.

소스

  • 앱 설정: ~/Library/Application Support/obsidian/obsidian.json
  • 기본 볼트 이름: obsidian
  • 일반적인 로컬 볼트 경로: ~/obsidian
  • 공식 CLI: obsidian
  • 볼트 명령은 현재 작업 디렉토리에서 볼트를 확인합니다. ~/obsidian에서 실행하세요.

첫 번째 확인

command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:

version 및 vaults 같은 전역 명령은 볼트 외부에서도 작동합니다. 볼트 내용 명령은 ~/obsidian 외부에서 Vault not found.를 출력할 수 있습니다. CLI 탐색에는 obsidian help 대신 obsidian commands를 사용하세요.

obsidian이 CLI가 비활성화되었다고 말하는 경우:

  1. 사용자에게 설정 -> 일반 -> 고급 -> 명령줄 인터페이스를 활성화하도록 요청하는 것이 좋습니다.
  2. 이미 앱 설정 형식을 확인했다면 ~/Library/Application Support/obsidian/obsidian.json에서 "cli": true를 사용합니다.
  3. 앱 수준 CLI 설정을 변경한 후 Obsidian을 다시 시작하세요.

읽기 워크플로

Obsidian 인식 조회에는 공식 CLI를 선호하세요:

cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json

이미 경로를 알고 정확한 바이트가 필요할 때는 직접 파일 시스템 읽기를 사용하세요:

sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"

신선도나 볼트 선택이 중요할 때는 어떤 소스를 사용했는지 보고하세요.

쓰기 워크플로

가장 좁은 쓰기 경로를 선택하세요:

  • 새 노트: obsidian create path="Folder/Note.md" content="...".
  • 일일 노트에 추가/앞에 추가: obsidian daily:append content="...".
  • 간단한 노트 편집: 마크다운 파일에 apply_patch를 사용하세요.
  • 노트 이름 바꾸기/이동: 링크가 업데이트될 수 있도록 obsidian move path="Old.md" to="Folder/New.md"를 선호하세요.
  • 쓰기 후 UI 열기: 유용하거나 요청된 경우에만 open을 추가하세요.

일반적인 명령:

cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"

여러 줄 내용의 경우, 경로를 알게 되면 apply_patch로 .md 파일을 편집하는 것이 좋습니다. 긴 산문에는 취약한 셸 인용을 피하세요.

베이스, 캔버스, 플러그인

먼저 CLI 탐색을 사용하세요:

cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:

.canvas, .base, .json 파일은 가능하면 구조화된 데이터로 읽고 편집하세요. 편집 후 형식을 안정적으로 유지하고 JSON을 검증하세요.

안전

  • 볼트를 일괄로 다시 작성하지 마세요. 대상 경로를 사용하고 차이점을 검토하세요.
  • 사용자가 요청하거나 작업이 명시적으로 설정/플러그인 작업이 아닌 한 .obsidian/을 편집하지 마세요.
  • 명시적으로 요청하지 않는 한 노트를 삭제하지 마세요. 영구 삭제보다는 휴지통을 선호하세요.
  • Obsidian URI/CLI 경로를 통해 숨겨진 점폴더 노트를 만들지 마세요.
  • 작업이 프론트매터나 위키링크를 리팩터링하는 작업이 아니라면 프론트매터와 위키링크를 유지하세요.
  • 여러 볼트가 존재하는 경우 추측하지 말고 obsidian vaults와 obsidian.json을 사용하세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬