obsidian-skills

Product Introduction

1. Definition: Obsidian Skills is a suite of open-source Agent Skills that enables AI agents and coding assistants to programmatically interact with Obsidian knowledge vaults. It falls under the technical categories of AI tool integration, knowledge management automation, and developer productivity tooling.
2. Core Value Proposition: It exists to bridge the critical gap between conversational AI and structured personal knowledge bases. Its primary function is to allow AI agents like Claude Code, Codex, and OpenCode to directly read, write, and manipulate content within Obsidian using its native open formats and command-line interface, solving the problem of AI assistants being siloed from a user's core knowledge system.

Main Features

1. obsidian-markdown Skill: This skill provides an AI agent with the precise syntax and capabilities to create and edit Obsidian Flavored Markdown (.md) files. It includes technical specifications for wikilinks (e.g., [[Internal Link]]), embedded files ![[...]], callouts (> [!info]), frontmatter properties, and other Obsidian-specific markdown extensions. The agent uses this knowledge to generate files that are natively compatible and fully functional within an Obsidian vault.
2. obsidian-bases Skill: This skill equips an AI agent to work with Obsidian Bases (.base files), a structured database-like format within Obsidian. It details how to construct views, apply filters, write formulas, and create summaries programmatically. This allows an AI to automate the organization and analysis of structured data stored in a vault.
3. json-canvas Skill: This skill provides the schema and methodology for an AI agent to generate and modify JSON Canvas files (.canvas). It covers the creation of nodes (text, file, link), edges (connections between nodes), groups, and their various properties. This enables AI-driven mind mapping and visual knowledge graph construction directly in Obsidian's canvas feature.
4. obsidian-cli Skill: This skill allows the AI agent to interact with the Obsidian vault through the official Obsidian Command Line Interface (CLI). This includes operations for plugin and theme development, vault management, and other CLI-driven automations, extending the agent's capabilities beyond simple file manipulation to vault-level operations.
5. defuddle Skill: This ancillary skill integrates the Defuddle tool, enabling the AI agent to extract clean, token-efficient markdown from web pages by removing advertisements, navigation, and other clutter. This optimizes content for processing and storage within the Obsidian vault.

Problems Solved

1. Pain Point: AI assistants lack direct, programmatic access to a user's centralized, structured knowledge stored in Obsidian vaults, forcing manual copy-pasting and breaking workflow continuity.
2. Target Audience: The primary user personas are developers, technical researchers, data scientists, and power users who utilize Obsidian for knowledge management and wish to integrate AI agents (Claude Code, Codex, OpenCode) into their research, writing, and coding workflows to automate interactions with their notes.
3. Use Cases: Specific scenarios include: an AI research assistant automatically saving summarized findings to a designated Obsidian note; a coding agent documenting its work in a project log within the vault; an AI automatically organizing meeting notes into a structured Base; or an agent building a JSON Canvas diagram from a structured data analysis.

Unique Advantages

1. Differentiation: Unlike generic markdown tools, Obsidian Skills is specifically tailored to Obsidian's unique syntax (wikilinks, properties, canvas JSON schema) and its CLI. It is not a standalone app but a standardized skill pack compliant with the Agent Skills specification, ensuring compatibility across multiple AI agent platforms.
2. Key Innovation: Its core innovation is the formalization of Obsidian's ecosystem—its file formats and CLI—into a standardized skill specification that any compatible AI agent can natively understand and execute. This turns Obsidian into a programmable platform for AI, leveraging open formats (Markdown, JSON) rather than a proprietary API.

Frequently Asked Questions (FAQ)

1. What AI agents are compatible with Obsidian Skills? Obsidian Skills is compatible with any agent that supports the Agent Skills specification, including Claude Code (via .claude folder), Codex (via ~/.codex/skills), and OpenCode (via ~/.opencode/skills/).
2. How do I install Obsidian Skills for use with Claude Desktop? To install for Claude Code, you add the contents of the Obsidian Skills repository to a /.claude folder located in the root directory of your Obsidian vault, as per Claude's official skills documentation.
3. Can Obsidian Skills create and edit Obsidian Canvas files? Yes, the json-canvas skill specifically provides the AI agent with the knowledge to create and edit .canvas files by understanding the JSON structure for nodes, edges, and groups used by Obsidian's canvas feature.
4. Does Obsidian Skills require the Obsidian CLI to be installed? The obsidian-cli skill requires the official Obsidian CLI to be installed on your system to function. The other skills (markdown, bases, canvas) only require the AI agent to have filesystem access to the vault.
5. What is the benefit of using the Defuddle skill with Obsidian? The Defuddle skill allows your AI agent to cleanly extract article content from web pages, removing excess HTML and saving tokens. This optimized markdown can then be directly saved to your Obsidian vault for efficient storage and future processing.