kepano

obsidian-skills

// summary

Obsidian-skills provides a collection of specialized tools designed to integrate Obsidian functionality with compatible AI agents. These skills adhere to the Agent Skills specification, enabling seamless interaction with platforms like Claude Code and Codex CLI. Users can install these tools via marketplace plugins, npx, or manual directory configuration to enhance their automated workflows.

// technical analysis

Obsidian-skills provides a standardized interface for AI agents to interact with Obsidian vaults by adhering to the Agent Skills specification. This design philosophy ensures interoperability across various agent platforms like Claude Code, Codex CLI, and OpenCode, allowing developers to automate note-taking and vault management tasks. By bridging the gap between LLM-based agents and Obsidian's proprietary file formats, the project enables sophisticated automation while maintaining compatibility with Obsidian-specific syntax and structures.

// key highlights

Supports Obsidian-flavored Markdown, enabling agents to create and edit files with wikilinks, callouts, and properties.

Includes specialized support for Obsidian Bases, allowing for the programmatic manipulation of views, filters, and formulas.

Provides JSON Canvas integration to facilitate the creation and editing of visual node-based diagrams and connections.

Enables direct interaction with Obsidian vaults through the Obsidian CLI for advanced tasks like plugin and theme development.

Integrates the Defuddle tool to extract clean markdown from web pages, which helps minimize token usage by removing unnecessary clutter.

// use cases

Create and edit Obsidian-flavored markdown files including wikilinks and callouts

Manage Obsidian Bases and JSON Canvas files through automated agent commands

Interact with Obsidian vaults and extract clean markdown from web pages using Defuddle

// getting started

To begin, install the skills using the marketplace commands, npx, or by manually cloning the repository into your agent's designated skills directory. Ensure you follow the specific directory structure requirements for your chosen agent, such as OpenCode or Claude Code, to allow for automatic discovery of the SKILL.md files. Once installed, your agent will be able to utilize the provided skills to interact with your Obsidian vault files directly.