obsidian

Manage Obsidian vaults and Markdown notes with automatic wikilink updates.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/chebizarro/swarmstr --skill obsidian-chebizarro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/chebizarro/swarmstr/tree/main/skills/obsidian
Command: npx skills add https://github.com/chebizarro/swarmstr --skill obsidian-chebizarro

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps users manage their Obsidian notes and vaults, automating tasks like searching, creating, moving, and deleting notes, while ensuring link integrity.

Core Features & Use Cases

  • Vault Management: Interact with Obsidian vaults, which are simply folders on disk.
  • Note Operations: Search for notes by name or content, create new notes, move/rename notes (with automatic link updates), and delete notes.
  • Configuration Awareness: Intelligently finds active vaults by reading Obsidian's configuration files, avoiding hardcoded paths.
  • Use Case: Quickly create a new note in your 'Projects' vault, link it to an existing note, and then refactor a related note's title, ensuring all internal links are updated automatically.

Quick Start

Use the obsidian skill to create a new note named 'Meeting Notes' in the 'Daily' folder of your default vault.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I automate Obsidian vault management and note operations from the command line?

Obsidian vault management is automated by using the obsidian-cli tool to search, create, move, and delete Markdown notes. It reads Obsidian's internal configuration files to intelligently locate active vaults without requiring hardcoded folder paths.

Do I need obsidian-cli installed to manage my Markdown notes and vaults?

Yes, the obsidian-cli dependency is required to interact with vault structures and Obsidian's internal settings. It provides the direct command-line interface needed to execute note operations and manage vault configurations on disk.

How do I move or rename a Markdown note without breaking internal wikilinks?

Moving or renaming Markdown notes is handled with automatic link integrity updates. When you relocate a file, the skill intelligently updates internal wikilinks across the vault to ensure all references to the renamed note remain connected.

Can I search for specific Markdown notes by name or content across multiple Obsidian vaults?

Yes, you can search for notes by name or content within your configured vaults. The skill uses configuration awareness to find active vaults, allowing you to locate specific Markdown files across your knowledge management system.

What is the best way to create a new Markdown note in a specific vault folder?

Creating a new Markdown note in a specific vault folder is done by specifying the target vault and path. The skill leverages configuration awareness to route the new file correctly, ensuring it is placed in the desired directory within your knowledge base.

Why does finding my active Obsidian vault require reading configuration files instead of using a fixed path?

Reading Obsidian's configuration files avoids hardcoded paths and ensures accurate vault detection. This configuration awareness allows the skill to dynamically locate active vaults on disk, preventing errors when managing Markdown notes across different environments.