obsidian

Manage Obsidian vault notes and refactor links automatically.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually managing large Obsidian vault note collections, refactoring links during reorganization, and searching across hundreds of Markdown notes is time-consuming and prone to human error like broken references.

Core Features & Use Cases

  • Vault Resolution: Automatically detect and resolve active Obsidian vaults from system configuration files, or use a user-set default vault for all operations.
  • Safe Note Refactoring: Create, move, rename, or delete notes while automatically updating all associated wikilinks and Markdown links to prevent broken references across the vault.
  • Full-Text Search: Search for notes by name or scan full note content for specific terms to quickly locate information in large knowledge bases.
  • Use Case: If you are reorganizing your personal research notes stored in Obsidian, use this skill to move entire note folders and automatically update all cross-references without manually editing each link.

Quick Start

Use the obsidian skill to find all notes in your default vault that mention the term "quarterly report" and list their file paths.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I automatically update Obsidian wikilinks when moving or renaming markdown notes?

To automatically update Obsidian wikilinks when moving or renaming markdown notes, use the obsidian skill to safely refactor note paths. It detects your active vault and rewrites all associated cross-references to prevent broken links during reorganization.

Can I search for specific text across all markdown notes in an Obsidian vault?

Yes, you can search for specific text across all markdown notes in an Obsidian vault by running a full-text search. The skill scans full note content for specific terms and returns the matching file paths for quick information location.

What is the best way to reorganize large folders of research notes without breaking cross-references?

The best way to reorganize large folders of research notes without breaking cross-references is to automate note operations with link refactoring. This skill handles folder moves and automatically updates all wikilinks and markdown links across your vault.

Do I need to manually specify my vault path for note management operations?

No, you do not need to manually specify your vault path for note management operations. The skill automatically detects and resolves active Obsidian vaults from system configuration files, or applies a user-set default vault for all commands.

Does vault automation support deleting markdown notes and cleaning up their incoming links?

Yes, vault automation supports deleting markdown notes and cleaning up their incoming links. When you delete a note through the skill, it automatically refactors associated wikilinks and markdown links to prevent broken references across the vault.