Pack · #19 trending skills repo · ↗ +1.5k stars this week
Obsidian Skills
obsidianmd/obsidian-skills
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
- Stars
- 52k
- This week
- +1.5k
- Forks
- 3.7k
- Open issues
- 2
- Skills inside
- 7
Get started
Install the skills
npx skills add https://github.com/obsidianmd/obsidian-skillsInstalls into Claude Code, Codex, Cursor, OpenCode and the other agents it finds on your machine.
/plugin marketplace add obsidianmd/obsidian-skills
/plugin install obsidian@obsidian-skillsRun inside Claude Code, then pick what to install from /plugin.
git clone --depth 1 https://github.com/obsidianmd/obsidian-skills.git /tmp/obsidian-skills
cp -r /tmp/obsidian-skills ~/.claude/skills/obsidian-skillsClaude Code reads ~/.claude/skills/ (or .claude/skills/ in a project). Other agents read the same SKILL.md format from their own skills folder.
Inside this repo
7 skills
plugins/obsidian/skills/defuddlejson-canvasCreate and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.plugins/obsidian/skills/json-canvasknapRender Markdown from templates and structured data using Knap CLI. Use when the user asks to apply a Knap template, turn JSON or CSV data into notes, batch-generate Markdown files, or format Defuddle output into a note.plugins/obsidian/skills/knapobsidian-basesCreate and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, kanban boards, filters, or formulas in Obsidian.plugins/obsidian/skills/obsidian-basesobsidian-cliInteract with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to inplugins/obsidian/skills/obsidian-cliobsidian-headlessSync and publish Obsidian vaults from the command line with Obsidian Headless (`ob`), without the desktop app. Use when the user wants to set up or run Obsidian Sync or Obsidian Publish on a server, in CI, or from a terminal, or change a vault's Sync or Publish settings.plugins/obsidian/skills/obsidian-headlessobsidian-markdownCreate and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.plugins/obsidian/skills/obsidian-markdownDocumentation
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
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 |
Releases