obsidian-skills
by obsidianmd
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
52,697stars
3,750forks
Shell
Added 11/15/2026
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
AI AgentsHermes Agent Hubagentsagentskillsbaseschatgptclaudeclaude-codeclaude-skillsclicodexdefuddlegrok-bothermesjsoncanvasknapmarkdownmdobsidianopenclawopencodeskills
Maintainer of this skill?
Installation
# Add to your Claude Code skills
git clone https://github.com/obsidianmd/obsidian-skillsGetting Started
Guides for using ai agents skills like obsidian-skills.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- How to Test an AI Skill: A Practical Guide to EvalsEvaluate skills with realistic fixtures, a baseline, and repeatable checks.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Compare with similar skills
See how obsidian-skills compares with popular alternatives.
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 git@github.com: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 |
Frequently Asked Questions
What is obsidian-skills?
obsidian-skills is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by obsidianmd. Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas. It has 52,697 GitHub stars.
Is obsidian-skills safe to use?
obsidian-skills's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
How do I install obsidian-skills?
Clone the repository with "git clone https://github.com/obsidianmd/obsidian-skills" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is obsidian-skills written in?
obsidian-skills is primarily written in Shell. It is open-source under obsidianmd on GitHub, so you can review or fork the full source.
Are there alternatives to obsidian-skills?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh obsidian-skills against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
Reverse engineer anything with agents, from app behavior down to native binaries.
460,718
112,885
TypeScript
AI Agentsagent-skillsai
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
303,435
44,733
JavaScript
AI Agentsai-agentsanthropic
Skills for Real Engineers. Straight from my .agents directory.
250,518
21,171
Shell
AI Agents
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming