obsidian

Guide Obsidian vault structuring, plugin development, URI automation, and Local REST API integration.

7|1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill obsidian-julianobarbosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/julianobarbosa/claude-code-skills/tree/main/skills/obsidian-skill
Command: npx skills add https://github.com/julianobarbosa/claude-code-skills --skill obsidian-julianobarbosa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, urllib3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides guidance on Obsidian vault structure, Local REST API, and plugin development to automate notes and knowledge workflows.

Core Features & Use Cases

  • Vault structure guidance: Best practices for Obsidian vault layout and config.
  • Plugin development: TypeScript plugin templates and lifecycle hooks.
  • URI schemes & automation: Obsidian URI automation and advanced workflows.

Quick Start

Create a basic Obsidian plugin skeleton and register a sample command.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I structure an Obsidian vault for knowledge management?

Vault structure in Obsidian follows best practices for organizing notes, metadata, and configurations. Use folder hierarchies aligned with your knowledge domains, configure vault settings for sync and plugins, and establish naming conventions for consistent retrieval and linking across your notes.

Can I automate Obsidian workflows using URI schemes?

Obsidian URI automation enables external tools to trigger actions within your vault—creating notes, opening files, executing commands. URI schemes accept parameters for vault selection, file paths, and content, allowing seamless integration between Obsidian and scripts or external applications.

How do I develop a custom Obsidian plugin?

Plugin development uses TypeScript templates and Obsidian's API—App, Vault, Workspace, MetadataCache, and FileManager—to extend functionality. Create a plugin skeleton, register commands or event listeners via lifecycle hooks, bundle with npm, and load into your vault for custom workflows.

What's the difference between using Obsidian URI schemes and the Local REST API?

URI schemes trigger actions from external applications into Obsidian; Local REST API provides programmatic read/write access to vault data via HTTP endpoints. Choose URI schemes for external automation or Local REST API when you need bidirectional data integration with external services.

Can I extend Obsidian markdown with custom syntax or rendering?

Markdown extensions in Obsidian plugins use the Markdown post-processor or custom rendering libraries to parse and display additional syntax. Plugins can register renderers for custom code blocks, add inline formatting, or transform markdown during note processing.

Do I need TypeScript knowledge to build an Obsidian plugin?

Yes, Obsidian plugins require TypeScript. The plugin template and API documentation provide scaffolding and examples; TypeScript knowledge lets you define types for vault data, event handlers, and UI components needed for plugin development.