SSkills导航
首页/Skills/Obsidian
文档与PDF中等风险

Obsidian

Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.

by @yakitrakv1.0.06 浏览3 下载
#cli#markdown#note-taking#obsidian#vault#wikilinks
推荐方式

直接交给 AI

无需安装文件。复制一句话，让 AI 在线读取这个 Skill。

下载 Skill ZIP ↓ 查看 SKILL.md 原文 ↗
01

它能帮你做什么

先看懂，再决定要不要交给 AI。

Provides guidance for working with Obsidian vaults, which are plain Markdown folders on disk. Covers vault structure (notes, config, canvases, attachments), locating the active vault via Obsidian desktop's config file, and using the obsidian-cli command-line tool to search, create, move/rename (with wikilink updates), and delete notes. Prefers reading config over hardcoded paths.

✓Locating the active Obsidian vault path
✓Searching note names and content via CLI
✓Creating new notes from the command line
✓Renaming notes while updating wikilinks across the vault
✓Automating Obsidian note operations from scripts
02

怎么交给 AI

在线读取优先，本地安装作为备选。

◎
在线读取推荐 · 不需要安装

适合能访问网页的 ChatGPT、Agent 或其他 AI。

AI Prompt请访问 https://skills.dhmip.cn/skills/yakitrak/obsidian/SKILL.md，读取并按照该 Skill 完成任务；如当前环境支持本地安装，也可以下载该 Skill。
↓
下载安装到 Agent适合支持 Skills 的客户端

未登录时可使用公共安装文档；登录后可以按不同 AI 分开管理。

Install Prompt请根据 https://skills.dhmip.cn/install/skillhub.md，安装 @yakitrak/obsidian。
登录后管理多个 AI →
03

兼容性与要求

安装或使用前，先确认环境是否匹配。

适用客户端

claude-desktopcursorwindsurfcline

使用要求

  • Obsidian desktop app installed
  • obsidian-cli binary installed (e.g., via Homebrew tap yakitrak/yakitrak/obsidian-cli)
  • macOS (paths reference ~/Library/Application Support/obsidian)
  • A configured Obsidian vault on disk
⌘技术详情查看完整 SKILL.md 与原始内容
⌄
SKILL.mdRaw ↗

name: obsidian
description: Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
homepage: https://help.obsidian.md
metadata: {"clawdbot":{"emoji":"💎","requires":{"bins":["obsidian-cli"]},"install":[{"id":"brew","kind":"brew","formula":"yakitrak/yakitrak/obsidian-cli","bins":["obsidian-cli"],"label":"Install obsidian-cli (brew)"}]}}

Obsidian

Obsidian vault = a normal folder on disk.

Vault structure (typical)

  • Notes: *.md (plain text Markdown; edit with any editor)
  • Config: .obsidian/ (workspace + plugin settings; usually don’t touch from scripts)
  • Canvases: *.canvas (JSON)
  • Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.)

Find the active vault(s)

Obsidian desktop tracks vaults here (source of truth):

  • ~/Library/Application Support/obsidian/obsidian.json

obsidian-cli resolves vaults from that file; vault name is typically the folder name (path suffix).

Fast “what vault is active / where are the notes?”

  • If you’ve already set a default: obsidian-cli print-default --path-only
  • Otherwise, read ~/Library/Application Support/obsidian/obsidian.json and use the vault entry with "open": true.

Notes

  • Multiple vaults common (iCloud vs ~/Documents, work/personal, etc.). Don’t guess; read config.
  • Avoid writing hardcoded vault paths into scripts; prefer reading the config or using print-default.

obsidian-cli quick start

Pick a default vault (once):

  • obsidian-cli set-default "<vault-folder-name>"
  • obsidian-cli print-default / obsidian-cli print-default --path-only

Search

  • obsidian-cli search "query" (note names)
  • obsidian-cli search-content "query" (inside notes; shows snippets + lines)

Create

  • obsidian-cli create "Folder/New note" --content "..." --open
  • Requires Obsidian URI handler (obsidian://…) working (Obsidian installed).
  • Avoid creating notes under “hidden” dot-folders (e.g. .something/...) via URI; Obsidian may refuse.

Move/rename (safe refactor)

  • obsidian-cli move "old/path/note" "new/path/note"
  • Updates [[wikilinks]] and common Markdown links across the vault (this is the main win vs mv).

Delete

  • obsidian-cli delete "path/note"

Prefer direct edits when appropriate: open the .md file and change it; Obsidian will pick it up.