Obsidian
- 18 installs
- 869 repo stars
- Updated June 8, 2026
- beita6969/scienceclaw
Obsidian is a skill that automates Obsidian Markdown vaults through the obsidian-cli command-line tool.
About
Lets an agent work with Obsidian vaults, which are plain Markdown folders on disk, and automate them through the obsidian-cli command-line tool. A developer uses it to find the active vault, search note names and content, and create, move, or delete notes. Move and rename operations update wikilinks and Markdown links across the vault, which is the main advantage over a plain file move.
- Automates Obsidian vaults through the obsidian-cli tool
- Search, create, move and delete notes from the terminal
- Rename/move updates [[wikilinks]] and Markdown links across the vault
Obsidian by the numbers
- 18 all-time installs (skills.sh)
- Ranked #2,053 of 3,280 Productivity & Planning skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
obsidian capabilities & compatibility
Free; local CLI only
- Capabilities
- note search · note create · note move
- Works with
- obsidian
- Platforms
- macOS
- Runs
- Runs locally
- Pricing
- Free
What obsidian says it does
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Updates `[[wikilinks]]` and common Markdown links across the vault (this is the main win vs `mv`).
Obsidian desktop tracks vaults here (source of truth):
npx skills add https://github.com/beita6969/scienceclaw --skill obsidianAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 18 |
|---|---|
| repo stars | ★ 869 |
| Last updated | June 8, 2026 |
| Repository | beita6969/scienceclaw ↗ |
What it does
Automate note search, creation, and safe link-preserving moves inside an Obsidian Markdown vault from the terminal.
Who is it for?
Searching, creating, and safely moving notes inside an existing Obsidian vault
Skip if: Editing .obsidian plugin/workspace config, which the docs say to usually leave untouched
When should I use this skill?
You need to find the active vault or search, create, move, or delete Obsidian notes from a script
What you get
Notes are searched, created, and moved with links updated automatically across the vault.
- Created, moved, or deleted Markdown notes
- Search results across note names and content
Files
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.jsonand 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 vsmv).
Delete
obsidian-cli delete "path/note"
Prefer direct edits when appropriate: open the .md file and change it; Obsidian will pick it up.
Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493kForks & variants (1)
Obsidian has 1 known copy in the catalog totaling 5 installs. They canonicalize to this original listing.
- firecrawl - 5 installs
FAQ
Does it need an API key?
No. It uses the local obsidian-cli tool installed via Homebrew and reads the local Obsidian config.
How does it find the active vault?
It reads ~/Library/Application Support/obsidian/obsidian.json, using the vault entry with "open": true, or obsidian-cli print-default.