npx Command to Add Obsidian Skills: Complete Installation Guide

Run npx skills add git@github.com:kepano/obsidian-skills.git to install the complete Obsidian Skills suite into any Agent Skills-compatible CLI such as Claude Code, Codex CLI, or OpenCode.

The kepano/obsidian-skills repository packages Obsidian-specific capabilities following the Agent Skills specification. You can add these skills to your agent using a single npx command that clones the repository and registers every SKILL.md file found in the skills/ directory.

The Exact npx Command to Add Obsidian Skills

According to the README.md installation section (lines 14-18), the exact command is:

npx skills add git@github.com:kepano/obsidian-skills.git

This command requires Node.js and works across macOS, Linux, and Windows without requiring a global package installation.

How the Installation Process Works

The npx skills add command performs three operations automatically.

1. Repository Cloning The CLI clones git@github.com:kepano/obsidian-skills.git into your agent's local skill store. For OpenCode, this typically maps to ~/.opencode/skills/.

2. Skill Discovery The tool scans the skills/ directory and registers each subfolder containing a SKILL.md file. The repository contains five primary skills:

• obsidian-markdown – Handles wikilinks, callouts, and front matter
• obsidian-bases – Manages database views, filters, and formulas
• json-canvas – Processes canvas node and edge definitions
• obsidian-cli – Interfaces with the Obsidian command line
• defuddle – Converts web pages to clean Markdown

3. Runtime Registration Each SKILL.md definition becomes available to your agent immediately without restarting the CLI.

Step-by-Step Installation Guide

Prerequisites

Ensure you have Node.js installed. The npx command downloads the skills CLI binary temporarily without polluting your global npm packages.

Adding the Skills

Execute the installation command in your terminal:

npx skills add git@github.com:kepano/obsidian-skills.git

Verifying Installation

Confirm the skills loaded correctly using your agent's list command. For OpenCode users:

opencode list-skills | grep obsidian

You should see entries for obsidian-markdown, obsidian-bases, and other installed skills.

Updating and Managing Skills

To refresh your local copy when the repository updates, re-run the same command:

npx skills add git@github.com:kepano/obsidian-skills.git

The CLI automatically pulls the latest commits and updates the skill definitions found in directories like skills/obsidian-markdown/ and skills/json-canvas/.

Using Installed Skills in Prompts

Once added, reference specific skills by name in your agent prompts:

You are an agent with the "obsidian-markdown" skill loaded.
Create a new note titled "Project Overview" that includes a callout, a wikilink to "Goals", and a front-matter property `created: {{date}}`.

The Agent Skills runtime invokes the implementation defined in skills/obsidian-markdown/SKILL.md to generate properly formatted Obsidian Markdown.

Summary

• The npx command to add Obsidian Skills is npx skills add git@github.com:kepano/obsidian-skills.git
• This clones the kepano/obsidian-skills repository and registers all SKILL.md files found under the skills/ directory
• Available skills include obsidian-markdown, obsidian-bases, json-canvas, obsidian-cli, and defuddle
• Re-run the same command to update skills when the repository changes
• Works with any Agent Skills-compatible CLI including Claude Code and OpenCode

Frequently Asked Questions

What is the exact npx command to add Obsidian Skills?

Run npx skills add git@github.com:kepano/obsidian-skills.git in your terminal. This executes the skills CLI without installing it globally, cloning the repository into your agent's skill store and registering all discovered SKILL.md files automatically.

Which agents support the npx skills command?

The command works with any CLI implementing the Agent Skills specification, including Claude Code, Codex CLI, and OpenCode. Each agent stores skills in a local directory such as ~/.opencode/skills/ and makes them available to the language model at runtime.

Where are the Obsidian Skills stored after installation?

The skills CLI clones the repository into your agent's skill store directory. For OpenCode, this is typically ~/.opencode/skills/obsidian-skills/, containing subdirectories like skills/obsidian-markdown/ and skills/obsidian-bases/. Each subdirectory includes a SKILL.md file defining that skill's behavior.

How do I update Obsidian Skills after installation?

Re-run the original command: npx skills add git@github.com:kepano/obsidian-skills.git. The CLI pulls the latest changes from GitHub and refreshes the local skill definitions, requiring no manual file management or reconfiguration.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}