obsidianmd/obsidian-skills
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
About obsidianmd/obsidian-skills
obsidianmd/obsidian-skills is an open-source project on GitHub, mainly written in Shell. Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas. It currently holds 53,009 stars and 0 forks with 0 open issues, and was last pushed on an unknown date (repository created unknown).
Project Overview
Git Homed tracks it on the AI Agent Skills Trending board and on the AI AI Agent Skills Trending list.
GitHub Repository Details
README
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
Gemini CLI
gemini extensions install https://github.com/obsidianmd/obsidian-skills
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.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.
Gemini CLI installs from the latest GitHub release, so publish a release for each version, tagged with the version number. The Gemini release archive workflow then attaches obsidian-gemini.tar.gz, which has real copies of the skills. Don't attach other files to a release, because Gemini CLI only picks a file when there's exactly one; otherwise it falls back to the source archive, which has no Gemini manifest. To build the archive locally, run ./scripts/package-gemini.sh.
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 |