obsidian

Manage Obsidian Markdown vaults by searching, creating, and refactoring notes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires obsidian-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the management and interaction with Obsidian vaults, which are plain Markdown note collections, by leveraging the obsidian-cli tool for automation.

Core Features & Use Cases

  • Vault Management: Easily set default vaults and query active vault information.
  • Note Operations: Search notes by title or content, create new notes, and safely move or rename existing notes while updating links.
  • Use Case: Quickly find all notes related to a specific project by searching content, or create a new daily note with a predefined template.

Quick Start

Use the obsidian skill to create a new note named 'Meeting Notes' in the 'Projects' folder with the content 'Discussed project roadmap.'.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I automate searching and creating notes in an Obsidian vault?

You can automate Obsidian vault management by using this Skill to search notes by title or content and create new Markdown notes via the obsidian-cli interface. It handles vault interactions programmatically without manual file editing.

Can I safely move or rename Markdown notes without breaking links in my vault?

Yes, safe refactoring operations like moving or renaming notes are supported natively. The Skill updates internal links automatically during these actions to maintain vault integrity and prevent broken references.

Do I need obsidian-cli installed to manage my knowledge base with this tool?

Yes, obsidian-cli must be installed and configured for vault access before use. This dependency is required for the Skill to interact with your Markdown knowledge base and execute vault queries.

What is the best way to find all notes related to a specific project in Obsidian?

The best way is to use the content search functionality to locate all related Markdown notes across your vault. This allows you to quickly retrieve project information by querying the text within your knowledge base.

How do I set a default vault for automated note management?

You can set default vaults and query active vault information using the built-in vault management features. This ensures all subsequent note operations target the correct Markdown collection automatically.

Are there limitations when automating Obsidian note operations across multiple vaults?

The Skill automates note operations across configured vaults but is limited by your obsidian-cli setup. Proper configuration of vault access is required to ensure safe refactoring and accurate search results.