Obsidian Skills Agent

---
name: obsidian-skills-agent
description: Teach AI coding agents to work with Obsidian vaults using Markdown, Bases, JSON Canvas, and the Obsidian CLI
triggers:
  - work with obsidian vault
  - create obsidian notes
  - edit obsidian markdown
  - use obsidian bases
  - create json canvas
  - interact with obsidian cli
  - add obsidian agent skills
  - teach agent obsidian syntax
---

# Obsidian Skills for AI Agents

> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.

`obsidian-skills` is a collection of agent skills that teach AI coding agents (Claude Code, Codex CLI, OpenCode, Cursor, etc.) how to work with Obsidian vaults. It covers Obsidian Flavored Markdown, Bases, JSON Canvas, and the Obsidian CLI — following the [Agent Skills specification](https://agentskills.io/specification).

---

## Installation

### Via Marketplace (if supported)

/plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills

### Via npx

```bash
npx skills add [email protected]:kepano/obsidian-skills.git

Claude Code (Manual)

Copy the repo contents into a /.claude folder at the root of your Obsidian vault:

git clone https://github.com/kepano/obsidian-skills.git /path/to/vault/.claude

Codex CLI (Manual)

Copy the skills/ directory into your Codex skills path:

git clone https://github.com/kepano/obsidian-skills.git /tmp/obsidian-skills
cp -r /tmp/obsidian-skills/skills/* ~/.codex/skills/

OpenCode (Manual)

Clone the full repo into the OpenCode skills directory:

git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

Do not copy only the inner skills/ folder. Clone the full repo so the path resolves to: ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md

OpenCode auto-discovers all SKILL.md files under ~/.opencode/skills/. Restart OpenCode after cloning.

Available Skills

Obsidian Flavored Markdown

Obsidian uses a superset of standard Markdown. Key syntax additions:

Properties (Frontmatter)

---
title: My Note
tags:
  - research
  - ai
date: 2026-03-01
status: draft
aliases:
  - My Research Note
---

Wikilinks

[[Note Name]]
[[Note Name|Display Text]]
[[Folder/Note Name]]
[[Note Name#Heading]]

Embeds