obsidian

Manage Obsidian vault files and Markdown notes via command-line automation.

5|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/tiancaiamao/ai --skill obsidian-tiancaiamao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/tiancaiamao/ai/tree/main/skills/obsidian
Command: npx skills add https://github.com/tiancaiamao/ai --skill obsidian-tiancaiamao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you work with Obsidian vaults as normal folders on disk, so you can automate note management instead of clicking through the app. It is useful when you need to search, create, move, rename, or delete Markdown notes reliably across one or more vaults.

Core Features & Use Cases

  • Vault discovery: Find the active Obsidian vault from the local desktop configuration instead of guessing paths.
  • Note automation: Search notes and note content, create new pages, and safely move or rename files while keeping links updated.
  • Workflow support: Use it to manage personal knowledge bases, project notebooks, research collections, and other Markdown-based vaults with less manual effort.

Quick Start

Ask the assistant to locate your active Obsidian vault and perform the note search, creation, move, or deletion task you want to automate.

Frequently Asked Questions about obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Obsidian vault files from the terminal?

Obsidian vault files from the terminal are managed through command-line automation that discovers local Markdown vaults and executes note search, creation, move, and deletion workflows safely.

How does vault discovery work for local Markdown notes?

Vault discovery for local Markdown notes works by reading the local Obsidian desktop configuration to automatically find the active vault path, eliminating directory guessing.

Do I need obsidian-cli to automate note workflows?

Yes, you need the obsidian-cli binary and access to the Obsidian desktop configuration to resolve vaults and update Markdown note links safely during automation.

Can I safely move and rename Markdown notes without breaking links?

Yes, you can safely move and rename Markdown notes without breaking links because the command-line automation resolves the Obsidian vault structure and updates internal links automatically.

What is the best way to search note content across multiple vaults?

The best way to search note content across multiple vaults is using command-line automation that targets personal knowledge bases and Markdown research collections directly on disk.