# npx Command to Add Obsidian Skills: Complete Installation Guide

> Install Obsidian Skills with the npx command.  Easily add the complete suite to your Agent Skills CLI like Claude Code and Codex CLI.

- Repository: [Steph Ango/obsidian-skills](https://github.com/kepano/obsidian-skills)
- Tags: how-to-guide
- Published: 2026-03-24

---

**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`](https://github.com/kepano/obsidian-skills/blob/main/SKILL.md) file found in the `skills/` directory.

## The Exact npx Command to Add Obsidian Skills

According to the [README.md](https://github.com/kepano/obsidian-skills/blob/main/README.md) installation section (lines 14-18), the exact command is:

```bash
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`](https://github.com/kepano/obsidian-skills/blob/main/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`](https://github.com/kepano/obsidian-skills/blob/main/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:

```bash
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:

```bash
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:

```bash
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:

```text
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`](https://github.com/kepano/obsidian-skills/blob/main/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`](https://github.com/kepano/obsidian-skills/blob/main/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`](https://github.com/kepano/obsidian-skills/blob/main/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`](https://github.com/kepano/obsidian-skills/blob/main/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.