How do I get started with obsidian-skills?

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

How popular is obsidian-skills on GitHub?

obsidianmd/obsidian-skills has 51,711 stars and 3,662 forks on GitHub, and gained 959 stars in the last 7 days.

What license does obsidian-skills use?

obsidianmd/obsidian-skills is released under the MIT license.

obsidianmd/obsidian-skillsPublic

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

AI summary: Agent Skills allowing autonomous AI coding assistants to interact with and manage Obsidian vaults directly.

Star on GitHub

Stars: 51.7K; +740 today
Forks: 3.7K
Watchers: 233
Open issues: 2
Open PRs: 0
Contributors: ~28
Commits: 100
Branches: 6

ShellMITCreated Jan 2, 2026Last push todayLatest release 1.1.0+959 stars this week+2.3K this month

Quick answers

What is obsidian-skills?: Agent Skills allowing autonomous AI coding assistants to interact with and manage Obsidian vaults directly.
What does obsidian-skills do?: Obsidian Skills provides a bridge between modern AI coding agents and the popular personal knowledge management tool, Obsidian. It adheres to the standardized Agent Skills specification, offering a suite of programmatic tools that agents can utilize to interact with the vault ecosystem. The repository contains specialized scripts and configurations that allow agents like Claude Code or Cursor to read, write, and organize markdown files seamlessly. This enables AI assistants to act as intelligent co-pilots within a user's knowledge base, automating tasks like note formatting, metadata extraction, or complex link generation. By exposing Obsidian's structure to autonomous agents, it significantly extends the capabilities of traditional note-taking workflows.
Who is obsidian-skills for?: Developers and power users who utilize both Obsidian for knowledge management and AI agents for workflow automation. It is particularly helpful for knowledge workers aiming to create complex, automated personal knowledge management systems.
How do I get started with obsidian-skills?: npx skills add [email protected]:kepano/obsidian-skills.git
How popular is obsidian-skills on GitHub?: obsidianmd/obsidian-skills has 51,711 stars and 3,662 forks on GitHub, and gained 959 stars in the last 7 days.
What license does obsidian-skills use?: obsidianmd/obsidian-skills is released under the MIT license.

Star history

since Jul 29, 2026

51.7K stars as of Nov 11, 2026. Measured daily since Jul 29, 2026; GitHub no longer exposes earlier star timestamps.

Contribution activity

commits per day, last 52 weeks

65 commits in the last yearLessMore

Signals and awards

derived from tracked data

Landmark project
51,711 stars
High momentum
+740 stars today
Actively maintained
Pushed within 48 hours
Permissive license
MIT
Continuous integration
Automated checks passing
Repeat trending
5 trending appearances

What obsidian-skills does

Obsidian Skills provides a bridge between modern AI coding agents and the popular personal knowledge management tool, Obsidian. It adheres to the standardized Agent Skills specification, offering a suite of programmatic tools that agents can utilize to interact with the vault ecosystem. The repository contains specialized scripts and configurations that allow agents like Claude Code or Cursor to read, write, and organize markdown files seamlessly. This enables AI assistants to act as intelligent co-pilots within a user's knowledge base, automating tasks like note formatting, metadata extraction, or complex link generation. By exposing Obsidian's structure to autonomous agents, it significantly extends the capabilities of traditional note-taking workflows.

Developers and power users who utilize both Obsidian for knowledge management and AI agents for workflow automation. It is particularly helpful for knowledge workers aiming to create complex, automated personal knowledge management systems.

Standardized specification: Adheres strictly to the Agent Skills protocol for out-of-the-box compatibility with major coding agents.
Vault manipulation: Allows agents to programmatically create, read, update, and delete markdown files within the Obsidian structure.
Seamless integration: Designed to be easily installed via package managers or direct git sourcing for rapid workflow setup.
Metadata management: Equips agents with the ability to safely parse and modify YAML frontmatter across multiple documents.
Automated organization: Provides the foundational tools needed for an AI to restructure folders or generate dynamic indexes.

Where teams use it

Automated refactoring

Command an AI agent to mass-update outdated frontmatter schemas across hundreds of notes simultaneously.

Content synthesis

Instruct a coding assistant to read an entire folder of meeting notes and generate a comprehensive summary document with bidirectional links.

Workflow automation

Utilize an agent to automatically format unorganized raw text dumps into clean, structured markdown adhering to specific templates.

Knowledge retrieval

Allow an AI to search through the vault structure using complex programmatic logic to find obscure, interconnected data points.

Getting started: npx skills add [email protected]:kepano/obsidian-skills.git

README

main branch

Agent Skills for use with Obsidian.

These skills follow the Agent Skills specification so they can be used by any skills-compatible agent, including Claude Code, Codex, and Open Code.

Installation

Claude Code marketplace

From terminal:

claude plugin marketplace add obsidianmd/obsidian-skills
claude plugin install obsidian@obsidian-skills

From within a Claude Code session:

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

To get new skills later, run claude plugin update obsidian@obsidian-skills.

Codex marketplace

codex plugin marketplace add obsidianmd/obsidian-skills

Then install Obsidian from the plugin directory in Codex or the ChatGPT desktop app.

Cursor

Install Obsidian from the Cursor Marketplace.

npx skills

npx skills add https://github.com/obsidianmd/obsidian-skills

To use ssh instead, if you have a GitHub SSH key set up:

npx skills add [email protected]:obsidianmd/obsidian-skills.git

Manually

Claude Code

Copy the plugins/obsidian/skills/ directory to .claude/skills/ in the root of your Obsidian vault (or whichever folder you're using with Claude Code). See more in the official Claude Skills documentation.

Codex

Copy the plugins/obsidian/skills/ directory into your Codex skills path (typically ~/.agents/skills). See the Agent Skills specification for the standard skill format.

OpenCode

Clone the entire repo into the OpenCode skills directory (~/.opencode/skills/):

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

Do not copy only the inner skills/ folder — clone the full repo so the directory structure is ~/.opencode/skills/obsidian-skills/plugins/obsidian/skills/<skill-name>/SKILL.md.

OpenCode auto-discovers all SKILL.md files under ~/.opencode/skills/. No changes to opencode.json or any config file are needed. Skills become available after restarting OpenCode.

Release maintenance

Update the plugin version in every manifest with:

./scripts/bump.sh patch

The script also accepts major, minor, or an explicit version like 1.1.0.

Skills

Skill	Description
obsidian-markdown	Create and edit Obsidian Flavored Markdown (`.md`) with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax
obsidian-bases	Create and edit Obsidian Bases (`.base`) with views, filters, formulas, and summaries
json-canvas	Create and edit JSON Canvas files (`.canvas`) with nodes, edges, groups, and connections
obsidian-cli	Interact with Obsidian vaults via the Obsidian CLI including plugin and theme development
obsidian-headless	Sync and publish vaults from the command line with Obsidian Headless, without the desktop app
defuddle	Extract clean markdown from web pages using Defuddle, removing clutter to save tokens
knap	Render Markdown templates from JSON or CSV data using Knap, including batch file generation

View on GitHub

Recent activity

commits and pull requests

1.2.0
kepano committed 3981277 · 7h ago
1.2.0Merged
#158 by kepano · updated 7h ago
Plugin: Bump to 1.2.0
kepano committed 85add51 · 7h ago
docs(obsidian-cli): add platform setup notes for WSL and headless LinuxMerged
#96 by citizen204 · updated 7h ago
docs: clarify properties prefix rule and add CLI/Bases prerequisitesMerged
#84 by hst368 · updated 7h ago
Skills: Fix Bases display names and add a WSL noteMerged
#157 by kepano · updated 7h ago
Skills: Fix Bases display names and add a WSL note
kepano committed 96cf4d1 · 7h ago
Skills: Trim the Bases prefix fix and add the WSL note
kepano committed 48a7ca3 · 7h ago
Merge pull request #96 from citizen204/docs/obsidian-cli-platform-notes
kepano committed 37a56a6 · 7h ago
Merge pull request #84 from hst368/fix-properties-prefix-and-prereqs
kepano committed 1527207 · 7h ago
docs: fix property types (closes #139), add Bases kanban viewMerged
#153 by bencharoenwong · updated 7h ago
Bases: Add kanban view
kepano committed 9cab719 · 7h ago

Recent open issues

view all

obsidian-cli: base commands don't follow the documented file/path targeting rules
#141 · 2mo ago · by datanerdie
[Feature Request] Awareness of Obsidian settings
#50 · 8mo ago · by ddxgz

Releases and announcements

1 total

1.1.01.1.0Nov 11, 2026
Obsidian Skills is now one plugin for Claude Code, Codex and Cursor, published by Obsidian. The repository moved to `obsidianmd/obsidian-skills`, and old links redirect. If you installed from the Claude Code marketplace, run `claude plugin update obsidian@obsidian-skills`. Earlier changes, including the Knap skill, didn't reach existing installs because the version stayed at 1.0.1 (#146). `scripts/bump.sh` now sets the version in every manifest. ### Plugin - Moved the skills to `plugins/obsidian/skills/`. - Added Codex and Cursor marketplaces next to the Claude one (#110, #142). - Added a plugin icon, README and license for the Claude, Codex, ChatGPT and Cursor directories. ### Skills - Obsidian CLI: `content=` converts every `\n` and `\t` with no escape, so the skill writes content with backslashes, such as LaTeX, directly to the file. - Obsidian CLI: documented how the CLI picks a vault, exit status 0 on errors, the update-links dialog that `rename` and `move` wait on, dots in file names, and `rename`, `move` and `delete` (#131, #132). - Obsidian CLI, Defuddle, Knap: check that the tool is installed and ask before installing it. - Markdown: escape alias pipes in tables, quot

Code frequency

additions and deletions

+8.1K lines added, -5.5K removed over the last year.

Commits per week

last 52 weeks

65 commits in the last 52 weeks.

When work happens

weekday and hour

Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Date	List	Rank	Stars gained
Jun 23, 2026	daily	#21	+7
Apr 7, 2026	daily	#23	+165
Jan 11, 2026	daily	#8	+297
Jan 10, 2026	daily	#2	+490
Jan 9, 2026	daily	#2	+300

morluto/rea
Reverse engineer anything with agents, from app behavior down to native binaries.
452.7K stars · TypeScript
openclaw/openclaw
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
394.4K stars · TypeScript
mattpocock/skills
Skills for Real Engineers. Straight from my .agents directory.
322K stars · Shell
obra/superpowers
An agentic skills framework & software development methodology that works.
316.3K stars · Shell
affaan-m/ECC
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
301.4K stars · JavaScript
NousResearch/hermes-agent
The agent that grows with you
262.7K stars · Python