Documentation Index
Fetch the complete documentation index at: https://mintlify.com/kepano/obsidian-skills/llms.txt
Use this file to discover all available pages before exploring further.
Obsidian Agent Skills can be installed in three ways: through the Claude Code plugin marketplace, via the npx skills CLI tool, or by manually placing files in the correct location for your agent. All three methods result in the same outcome — skills are auto-discovered by your agent at startup, with no configuration files to edit and no prompts to write.
Marketplace
npx skills
Manual
The marketplace method is the fastest way to install for Claude Code users. Run the following two commands inside a Claude Code session:/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills
obsidian plugin bundle. Claude Code will auto-discover the included skills on next startup. If you have Node.js available, you can use the npx skills tool to install directly from the GitHub repository. Choose either SSH or HTTPS depending on your git setup:npx skills add git@github.com:kepano/obsidian-skills.git
npx skills tool handles cloning and placement automatically, following the Agent Skills specification conventions for wherever your agent expects to find skill files. You can install the skills manually for any supported agent. Follow the steps for your agent below. Claude Code
Codex
OpenCode
Clone or download the repository
git clone https://github.com/kepano/obsidian-skills.git
Copy contents to your vault's .claude folder
Add the entire contents of the cloned repository to a /.claude folder at the root of your Obsidian vault (or whichever folder you are opening with Claude Code):cp -r obsidian-skills/. /path/to/your/vault/.claude/
Restart Claude Code
Claude Code will auto-discover the skills on next startup. No changes to any config file are needed.
Clone or download the repository
git clone https://github.com/kepano/obsidian-skills.git
Copy the skills/ directory to your Codex skills path
cp -r obsidian-skills/skills/ ~/.codex/skills/
~/.codex/skills. Refer to the Agent Skills specification if your setup uses a different path.Restart Codex
Codex will auto-discover all SKILL.md files in the skills directory on next startup.
Clone the full repository into ~/.opencode/skills/obsidian-skills/ — do not copy only the inner skills/ subfolder. OpenCode requires the directory structure ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md to discover skills correctly.
Clone the full repository into the OpenCode skills directory
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills
~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md, which is the path OpenCode expects.Restart OpenCode
OpenCode auto-discovers all SKILL.md files under ~/.opencode/skills/. No changes to opencode.json or any other config file are required. Skills become available immediately after restarting.
After Installation
Once the skills are installed, your agent will automatically load the relevant skill whenever it detects a matching file type or user intent — for example, when you open a .base file or ask about Canvas nodes. There is nothing else to configure. The skills are written in plain Markdown and YAML, so you can inspect or customise any SKILL.md file at any time.
The obsidian-cli skill requires Obsidian to be running in the background. The Obsidian CLI communicates with the Obsidian app over a local connection, so the app must be open for CLI commands to work.