Obsidian Skills
Teach your agent to work with Obsidian Markdown, Bases, JSON Canvas, and CLI.
Evidence shows the repository follows the Agent Skills specification, skills provide only instructions and examples, no excessive permissions or dangerous operations found. However, lacks user confirmation mechanisms, data flow transparency, sensitive data handling, dependency security audit, external effects control, rollback. Source attribution via MIT license and author name, but publisher unverified.
Skill descriptions are consistent with README skill list, but no error handling or failure messages provided. Dependencies (e.g., Obsidian CLI, Defuddle) mentioned in README, but no version or availability guarantees.
README clearly identifies target users (Obsidian users) and multiple installation scenarios (Claude Code, Codex, OpenCode), but trigger conditions not detailed, capability boundaries only implied by skill descriptions. Environment fit covers mainstream tools, but version compatibility not specified.
Information architecture clear, README provides installation instructions and skill list, but lacks known limitations, version changelog, maintenance responsibility. License is MIT, naming stable but no version number.
Skill outputs are Markdown, Bases, JSON Canvas formats, directly usable in Obsidian, but no examples or FAQ. Marginal value in saving tokens and simplifying Obsidian operations, but cost-benefit not quantified.
Claims in README (e.g., skills follow specification) traceable to external spec, but no independent verification. Skill descriptions consistent with README, but no separation of facts and inferences.
- Publisher identity unverified; review skill contents before use.
- Lacks user confirmation mechanisms; skills may automatically perform modifications.
- Dependencies (e.g., Obsidian CLI) versions not pinned, may introduce incompatibility or security risks.
- No rollback provided; accidental operations may cause data loss.
What does this agent do, and when should you use it?
This repository provides a set of agent skills for interacting with Obsidian, following the Agent Skills specification. It includes five skills: obsidian-markdown for editing Obsidian Flavored Markdown, obsidian-bases for handling .base files, json-canvas for .canvas files, obsidian-cli for vault interaction via CLI, and defuddle for extracting clean markdown from web pages. These skills are compatible with skills-compatible agents like Claude Code, Codex, and OpenCode. Installation can be done via marketplace, npx, or manual configuration into each agent's directory. Each skill defines specific operations and output formats, enabling agents to directly handle Obsidian files.
The package provides predefined skills that enable compatible agents to perform Obsidian-related tasks. It includes five skills: obsidian-markdown for creating and editing Obsidian Flavored Markdown files with wikilinks, embeds, callouts, properties, and other syntax; obsidian-bases for creating and editing .base files with views, filters, formulas, and summaries; json-canvas for creating and editing .canvas files with nodes, edges, groups, and connections; obsidian-cli for interacting with vaults via the Obsidian CLI for plugin and theme development; and defuddle for extracting clean markdown from web pages using Defuddle to save tokens. Agents follow the skill instructions to perform actions and produce outputs in Obsidian formats.
- An Obsidian user wants Claude Code to create notes with wikilinks and callouts in their vault, using the obsidian-markdown skill.
- A researcher needs to extract clean, clutter-free markdown from web pages into Obsidian, using the defuddle skill.
- A developer uses the Obsidian CLI to manage plugins and themes, interacting via the obsidian-cli skill.
- A knowledge manager needs to create and edit Obsidian Bases files to organize data, using obsidian-bases.
- A visual thinker uses JSON Canvas to map ideas with nodes and connections, using json-canvas to manipulate .canvas files via an agent.
- A team standardizes on Agent Skills and wants unified Obsidian skills across multiple agent environments like Claude Code, Codex, and OpenCode.
What are this agent's strengths and limitations?
- Adheres to the standardized Agent Skills specification, enabling use across multiple agent environments.
- Comprehensive coverage of Obsidian features, from Markdown to Bases to JSON Canvas.
- Includes a Defuddle-based skill for efficient web content extraction, saving tokens.
- Offers multiple installation methods (marketplace, npx, manual), flexible to different workflows.
- Depends on the Obsidian application and its CLI, requiring users to have Obsidian and relevant tools.
- Skills are Obsidian-specific and not applicable to other note-taking apps.
- Installation involves multiple steps, which may be a barrier for non-CLI-savvy users.
- Effectiveness relies on the agent's adherence to SKILL.md instructions, which may vary across agents.
How do you install or deploy this agent?
Install via marketplace: In Obsidian, run /plugin marketplace add kepano/obsidian-skills then /plugin install obsidian@obsidian-skills.
Install via npx: Run npx skills add [email protected]:kepano/obsidian-skills.git (or use the https URL).
Manual install for Claude Code: Add the contents of the repo to a /.claude folder in the root of your Obsidian vault.
Manual install for Codex: Copy the skills/ directory into ~/.codex/skills.
Manual install for OpenCode: Clone the entire repo into ~/.opencode/skills/ to preserve the directory structure.
How do you use this agent?
After installation, skills are auto-discovered based on your agent environment. For Claude Code, ensure skills are in /.claude; for Codex, they are in ~/.codex/skills; for OpenCode, ensure the structure ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md exists. Then invoke the skills in conversation, e.g., ask the agent to create a Markdown note or extract web content. The skills guide the agent through specific operations. For the obsidian-cli skill, you must have the Obsidian CLI installed.
How does this agent compare with similar options?
Compared to general-purpose skill packs, this repository focuses on the Obsidian ecosystem, while others may cover broader file operations. It follows the agentskills.io specification, competing with other skills that support that standard.