Obsidian

This gives you what you need to work with Obsidian programmatically. The URI scheme gets you basic automation like opening notes or triggering searches from external scripts. If you're building plugins, you get the full TypeScript API with vault operations, workspace management, and event handling. The Local REST API section is the real workhorse for external integration, complete with Python examples for reading, writing, and searching notes over HTTP. It also covers the wikilink syntax and embed patterns that make Obsidian's internal linking work. Use this when you're automating workflows, building custom plugins, or need to query your knowledge base from scripts outside Obsidian itself.

skills.sh installs: 243
GitHub stars: 15
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add julianobarbosa/claude-code-skills --skill obsidian --agent claude-code

Installs into .claude/skills of the current project.

Files

Obsidian

Overview

This skill provides comprehensive guidance for working with Obsidian, a powerful knowledge management and note-taking application. It covers vault structure, the Obsidian API for plugin development, URI scheme automation, markdown extensions, and integration with external tools via the Local REST API.

Quick Reference

Vault Structure

my-vault/
├── .obsidian/              # Configuration folder
│   ├── app.json            # App settings
│   ├── appearance.json     # Theme settings
│   ├── community-plugins.json  # Installed plugins list
│   ├── core-plugins.json   # Core plugin toggles
│   ├── hotkeys.json        # Custom keybindings
│   ├── plugins/            # Plugin data folders
│   │   └── <plugin-id>/
│   │       ├── main.js     # Compiled plugin code
│   │       ├── manifest.json
│   │       └── data.json   # Plugin settings
│   └── workspace.json      # Layout state
├── Notes/                  # User notes (any structure)
├── Attachments/            # Images, PDFs, etc.
└── Templates/              # Template files