Obsidian Skills: notes, Bases, Canvas and vault commands
obsidianmd/obsidian-skills
Seven skills from the Obsidian team that teach your AI assistant how Obsidian works. It writes notes, table and board views and canvases in the exact format Obsidian reads. With the Obsidian app open, it can also search, read, create and move notes in your vault, and it can save web pages as clean notes.
Pack description by its author: “Seven skills from the Obsidian team that teach your AI assistant how Obsidian works. It writes notes, table and board views and canvases in the exact format Obsidian reads. With the Obsidian app open, it can also search, read, create and move notes in your vault, and it can save web pages as clean notes.”
Planning, memory and productivityKnowledge and rules for your assistant
1. Changes your files
Skills that write or edit files: obsidian-markdown, obsidian-bases, json-canvas, obsidian-cli, obsidian-headless, defuddle, knap.
github.com/obsidianmd/obsidian-skills/blob/3981277/2. Runs code on your machine
Install: Seven skill folders of markdown text. No hooks, no server, no background programs. scripts/bump.sh at the repository root only updates version numbers for the maintainers and is not part of the plugin. obsidian-cli at work: Tells your assistant to run the obsidian command that ships with the Obsidian app; it talks to the running app on your computer and can create, change, move or delete notes.
github.com/obsidianmd/obsidian-skills/blob/3981277/3. Sends data
Notes you ask about go into the conversation and are processed by your AI model. The obsidian-cli skill can run JavaScript inside the app (eval) and delete or overwrite notes; the skill tells the assistant to prefer dedicated commands and use overwrite only when replacing a file is intended.
github.com/obsidianmd/obsidian-skills/blob/3981277/Checked against the pack's files at commit 3981277, on Nov 12, 2026. Tap a verdict to see its source.How we checkedReport an error
Good for you if
- You keep notes in Obsidian and want your assistant to read, search and organise them
- You want the assistant to build Obsidian Bases views (tables, cards, kanban boards) or Canvas boards for you
- You want web articles saved as tidy notes, or many notes made from one template and a spreadsheet
- You use Claude Code, Codex, Cursor or OpenCode
Probably not for you if
- You only use a chat window with no terminal: the vault commands need an assistant that can run local commands
- You want your notes sorted and linked for you on autopilot: these skills explain formats and commands, they do not organise a vault on their own
What its answer looks like
A kanban board of projects (the Bases skill's own example)
views:
- type: kanban
name: "Projects"
groupBy:
property: note.status
direction: ASC
groupOrder:
- Planned
- In progress
- Done
order:
- file.name
- due_date
The skill's own example, from plugins/obsidian/skills/obsidian-bases/SKILL.md. More examples
What you'll notice
- Notes come out with Obsidian links ([[Note]]), properties at the top, callouts and embeds that render in Obsidian
- New .base and .canvas files that open in Obsidian as tables, card galleries, kanban boards and boards of linked cards
- Before vault commands, the assistant checks that the Obsidian app is open with its command line turned on
- When a helper tool is missing, the assistant asks before installing it
What you need
- Claude Code, Codex, Cursor, OpenCode
- Mixed, MIT license
- Add the marketplace and install the obsidian plugin, or copy the skills folder
- The skills are free. Vault commands need the Obsidian desktop app running with its command line turned on. Sync and Publish need a paid Obsidian Sync or Publish subscription. Web extraction, templates and Sync use separate tools that need Node.js and are installed only after you agree.
Words on this page
- Skill
- A set of written instructions your AI assistant follows. Installing one is like giving it a playbook.
- Plugin
- A package your assistant installs that can bring skills, commands and hooks together.
- CLI
- A program you run by typing commands in a terminal.
| Repository | obsidianmd/obsidian-skills |
|---|---|
| GitHub stars | 52,679 |
| Skills | 7 |
| Category | Planning, memory and productivity |
| License | MIT |
| Last updated | Nov 11, 2026 · card checked Nov 12, 2026 at commit 3981277 |
| Install counts | obsidianmd/obsidian-skills on skills.sh, Vercel's skills directory, which shows installs and security audits per skill |
obsidianmd/obsidian-skills popularity over time
What Obsidian Skills does
- Obsidian Markdown: wikilinks, embeds, callouts, properties, tags, comments, highlights, math, Mermaid diagrams and footnotes, with a five-step workflow for a new note
- Bases: the YAML format of .base files, with filters, formulas, summaries and table, cards, list, map and kanban views, plus a list of common errors and fixes
- JSON Canvas: nodes, edges, groups, colour presets, ID rules, layout sizes and a validation checklist for .canvas files
- Obsidian CLI: read, create, append, rename, move, delete and search notes, daily notes, tasks, properties and backlinks through the running app; plus reload, error, screenshot and DOM commands for plugin and theme developers
- Obsidian Headless (ob): set up and run Obsidian Sync and Obsidian Publish from a terminal or server, without the app
- Defuddle: turn a web page into clean Markdown without menus and ads
- Knap: render Markdown notes from a template and JSON or CSV data, one note or a whole batch
Never cut, per the skill: ['Use rename and move, not a plain file move, so Obsidian updates links to the note', 'delete moves the note to the trash; permanent deletion only when you ask', 'Publish runs a dry run first and shows you the changes'].
From the pack's SKILL.md files, summarised by AgentGid.
The 7 skills, explained
obsidian-markdown
Writes and edits notes in Obsidian's own style, with links, callouts, properties and embeds
You give
- The note's topic and content
- Notes in your vault it should link to
- Properties you want, such as tags or status
You get
- A note with properties at the top
- [[Links]] to other notes, embeds and callouts
- A check that it shows correctly in Obsidian's reading view
obsidian-bases
Builds Obsidian Bases, saved views that show your notes as a table, cards, a list, a map or a kanban board
You give
- Which notes to include: a tag, folder, property or date
- Which columns or properties to show
- The view you want: table, cards, list, map or kanban
You get
- A .base file with filters and views
- Optional formulas, such as days until a due date
- Summaries such as sums or averages
- A check that the file is valid
json-canvas
Draws Obsidian Canvas boards, cards and arrows connecting ideas, notes, images and links
You give
- The ideas, notes or links to place
- How they connect, and labels for the arrows
- Groups to box them in, if any
You get
- A .canvas file with cards, groups and arrows
- A layout with spacing between cards
- A check that every arrow points at a real card
obsidian-cli
Searches, reads, creates, moves and deletes notes in your vault through the open Obsidian app; also helps people building Obsidian plugins and themes
You give
- What to find or change
- Which vault, if you have several
You get
- Search results, note text, tasks, tags or backlinks
- New or updated notes, renamed or moved with links kept
- For plugin developers: reload, error list, screenshot and console output
obsidian-headless
Runs Obsidian Sync and Obsidian Publish from a terminal or server, without the app
You give
- The vault folder
- The remote vault or Publish site name
- Your Obsidian login, typed by you in your own terminal
You get
- A vault linked to Sync, synced once or continuously
- A Publish dry run to review, then the publish
- Sync and Publish settings changed as you ask
defuddle
Turns a web page into clean text without menus and ads, to read or save as a note
You give
- The page address
You get
- The page as Markdown, or saved to a file
- Or one detail: title, description or site
knap
Fills a note template with data, making one note or one note per spreadsheet row
You give
- A template
- Data: a JSON file, a CSV spreadsheet or a folder of JSON files
- A folder for the new notes
You get
- One rendered note, or one note per row or item
- A dry run that lists the files first
- Template checks before rendering
See it in action
The skill defines what its answer looks like. Its own example:
views:
- type: kanban
name: "Projects"
groupBy:
property: note.status
direction: ASC
groupOrder:
- Planned
- In progress
- Done
order:
- file.name
- due_date
The skill defines what its answer looks like. Its own example:
obsidian-markdown/SKILL.md ends with a full "Project Alpha" note (properties, a callout, tasks, a math line, an embedded image). obsidian-bases/SKILL.md has a task tracker, a reading list and a daily notes index. json-canvas/references/EXAMPLES.md has a simple canvas, a project board with groups, a research canvas and a flowchart.
From plugins/obsidian/skills/json-canvas/references/EXAMPLES.md.
When to reach for it
| You want | Use |
|---|---|
| Notes written with Obsidian links, callouts and properties | obsidian-markdown |
| A table, card gallery or kanban board of your notes | obsidian-bases |
| A board of connected ideas, a mind map or a flowchart | json-canvas |
| Search, read or reorganise notes in your vault | obsidian-cli (Obsidian app open) |
| Sync or publish a vault from a server or terminal | obsidian-headless |
| A web article saved as a clean note | defuddle, then knap for a template |
| Many notes from one template and a spreadsheet | knap |
Skills in obsidianmd/obsidian-skills
| Skill | In plain words | Changes files? | What it does (author) |
|---|---|---|---|
| defuddle | Turns a web page into clean text without menus and ads, to read or save as a note | Yes | Extract clean Markdown from HTML pages with Defuddle CLI.npx skills add obsidianmd/obsidian-skills --skill defuddle |
| json-canvas | Draws Obsidian Canvas boards, cards and arrows connecting ideas, notes, images and links | Yes | Create 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.npx skills add obsidianmd/obsidian-skills --skill json-canvas |
| knap | Fills a note template with data, making one note or one note per spreadsheet row | Yes | Render 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.npx skills add obsidianmd/obsidian-skills --skill knap |
| obsidian-bases | Builds Obsidian Bases, saved views that show your notes as a table, cards, a list, a map or a kanban board | Yes | Create 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.npx skills add obsidianmd/obsidian-skills --skill obsidian-bases |
| obsidian-cli | Searches, reads, creates, moves and deletes notes in your vault through the open Obsidian app; also helps people building Obsidian plugins and themes | Yes | Interact 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…npx skills add obsidianmd/obsidian-skills --skill obsidian-cli |
| obsidian-headless | Runs Obsidian Sync and Obsidian Publish from a terminal or server, without the app | Yes | Sync 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.npx skills add obsidianmd/obsidian-skills --skill obsidian-headless |
| obsidian-markdown | Writes and edits notes in Obsidian's own style, with links, callouts, properties and embeds | Yes | Create 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.npx skills add obsidianmd/obsidian-skills --skill obsidian-markdown |
The author's descriptions come from each skill's SKILL.md; the plain-words column is AgentGid's.
Good to know before you install
- The vault commands only work with the Obsidian desktop app open and its command line turned on in settings.
- Notes you ask about are sent into the conversation and processed by the AI model you use, not only on your computer.
- No background programs: the plugin is skills only, with no hooks and no server.
- Helper tools (Defuddle, Knap, Obsidian Headless) are not included; when one is missing, the assistant offers a global install from npm and asks first.
- Do not run the app's Sync and command-line Sync on the same vault on the same computer; back up the vault before the first sync.
- The obsidian command comes with the Obsidian installer; an unrelated npm package with a similar name is not it.
Before you start
Works in
- Claude Code: plugin
- Codex: plugin
- Cursor: plugin
- OpenCode: skills folder
- Any skills-compatible agent: skills folder (npx skills)
You will need
- Obsidian desktop app with the CLI turned on: obsidian-cli talks to the running app
- Node.js 20+ and Knap: knap renders templates
- Node.js 22+, Obsidian Headless and a Sync or Publish subscription: obsidian-headless syncs and publishes
- Defuddle CLI: defuddle extracts web pages
Steps only you can do
- Install the Obsidian desktop app, open it and turn on its command line (https://help.obsidian.md/cli)
Then: The assistant runs obsidian help to check, then works with the vault - Log in to Obsidian Headless with ob login in your own terminal (email, password, 2FA) (https://help.obsidian.md/headless)
Then: The assistant lists vaults or sites and sets up Sync or Publish - Have an active Obsidian Sync or Publish subscription (https://obsidian.md/)
Then: The assistant can sync or publish the vault - Approve a global npm install of Defuddle, Knap or Obsidian Headless when the assistant asks (your terminal)
Then: The assistant runs the missing tool - Enter the encryption password yourself when setting up an end-to-end encrypted vault (your terminal (ob sync-setup))
Then: The vault is linked and syncs
Mistakes to avoid
Install the npm package obsidian-cli to get the obsidian command
Turn on the CLI in the Obsidian desktop app; the command ships with the installer
The npm package with that name is unrelatedTrust the exit status of an obsidian command
Read the command's output before reporting success
The CLI exits with status 0 even when a command failsPass long text or text with backslashes through content=, or create a .canvas file with obsidian create
Write such notes and all .canvas files directly to the file
Every \n and \t in content= is converted, which corrupts LaTeX, Windows paths and canvas JSONRun the desktop app's Sync and Headless Sync on the same vault on one device
Use one of them per vault per device, and back up the vault before the first sync
The two cause sync conflictsWrite bare property names in the top-level properties section of a .base file
Use the note. prefix there, e.g. note.author
Obsidian ignores a bare key there and shows the raw name as the column header
Which one to pick
| If you need | Pick |
|---|---|
| You want the official formats and commands for notes, Bases, Canvas, the Obsidian CLI, Sync and Publish | This pack |
| You want an assistant that files and links everything you drop into a self-organising second brain | AgriciDaniel/claude-obsidian |
| You want a vault that works as persistent memory for coding agents | breferrari/obsidian-mind |
| You want Canvas, Excalidraw and Mermaid diagrams generated from text | axtonliu/axton-obsidian-visual-skills |
Works well with
May I use it like this?
| Use | Answer | Condition |
|---|---|---|
| In a commercial app | Yes | MIT |
| Work for clients | Yes | MIT |
| Passing the files on | Yes | MIT: keep the copyright and permission notice in copies |
| Shipped inside your app | Yes | MIT: keep the notice |
What leaves your machine
- Vault content you ask about → The AI model your assistant uses, Whenever notes are read into the conversation. Opt out: Ask only about notes you are fine sending to the model
- A request for the web page → The site you name, When the defuddle skill extracts a page. Opt out: Do not use the defuddle skill
- Vault files, and notes marked for publishing → Obsidian Sync and Obsidian Publish servers, When ob sync or ob publish runs. Opt out: Do not use the obsidian-headless skill
Install Obsidian Skills
Official commands from the repository
claude plugin marketplace add obsidianmd/obsidian-skills claude plugin install obsidian@obsidian-skills
Or inside a session: /plugin marketplace add obsidianmd/obsidian-skills, then /plugin install obsidian@obsidian-skills. Update later with claude plugin update obsidian@obsidian-skills.
codex plugin marketplace add obsidianmd/obsidian-skills
Then install Obsidian from the plugin directory in Codex or the ChatGPT desktop app.
Install Obsidian from the Cursor Marketplace.
npx skills add https://github.com/obsidianmd/obsidian-skills
Copy plugins/obsidian/skills/ to .claude/skills/ in the root of your vault.
Remove: delete the copied folders from .claude/skills/
Copy plugins/obsidian/skills/ into your Codex skills path, typically ~/.agents/skills.
Remove: delete the copied folders
git clone https://github.com/obsidianmd/obsidian-skills.git ~/.opencode/skills/obsidian-skills
Clone the whole repository, not only the inner skills folder, then restart OpenCode.
Remove: delete ~/.opencode/skills/obsidian-skills
Or with the open-source skills CLI: npx skills add obsidianmd/obsidian-skills. Skills are instructions your agent follows: read them before installing.
What it installs and runs on your machine
Read in the code at commit 3981277, Nov 12, 2026
| When | What happens |
|---|---|
| Install | Seven skill folders of markdown text. No hooks, no server, no background programs. scripts/bump.sh at the repository root only updates version numbers for the maintainers and is not part of the plugin. |
| obsidian-cli at work | Tells your assistant to run the obsidian command that ships with the Obsidian app; it talks to the running app on your computer and can create, change, move or delete notes. |
| defuddle at work | Tells your assistant to run Defuddle, which downloads the web page you name. |
| obsidian-headless at work | Tells your assistant to run ob, which syncs your vault with Obsidian Sync or uploads notes to Obsidian Publish. |
| A helper tool is missing | The assistant offers npm install -g defuddle, npm install -g knap (or npx knap) or npm install -g obsidian-headless, after asking you. |
Quick answers
- Does it work in a plain chat without a terminal?
- Partly. The Markdown, Bases and Canvas skills only describe file formats, so they work in chat. Vault commands, Sync, web extraction and templates need an assistant that can run local commands.
- Do I need to pay?
- The skills are free under MIT. Obsidian Sync and Publish, used by the obsidian-headless skill, need a subscription.
- Will the assistant ask for my Obsidian password?
- No. The skill tells it to have you run the login in your own terminal and not to ask for your password.
- Can it delete my notes for good?
- Its delete moves notes to the trash; permanent deletion only when you ask for it.
- Does it work with the app closed?
- Vault commands need the app open. Obsidian Headless runs Sync and Publish without the app; to read or change notes without it, the assistant edits the files directly.
Checked by AgentGid on Nov 12, 2026 against commit 3981277 of the pack's own files. Related: kepano/defuddle, obsidianmd/knap, obsidianmd/jsoncanvas. agent.md for AI agents · Report a mistake
More planning, memory and productivity skill packs
| # | Skill pack | Skills | GitHub stars | Updated |
|---|---|---|---|---|
| 1 |
career-ops-hq/career-ops Your AI assistant becomes a job search helper that works from a folder on your computer. Paste a job link and it checks the job i…
|
1 | 82.6K | 2026-11-15 |
| 2 |
ayghri/i-have-adhd Your AI assistant puts the next thing to do on the first line. It numbers the steps, gives time in minutes or hours, says where y…
|
1 | 61.2K | 2026-10-19 |
| 3 |
sickn33/agentic-awesome-skills A very large library of ready instructions for AI assistants: about 2,750 skills for coding, debugging, security, marketing, SEO,…
|
2956 | 49.7K | 2026-11-14 |
| 4 |
AgriciDaniel/claude-obsidian Your assistant turns the articles, papers and notes you drop into a folder into linked, cited notes in an Obsidian vault. You can…
|
16 | 16.5K | 2026-10-25 |
| 5 |
nidhinjs/prompt-master Your assistant turns a rough idea into one finished prompt for the AI tool you name: ChatGPT, Cursor, Claude Code, Midjourney, So…
|
1 | 16K | 2026-10-22 |
| 6 |
handsomestWei/patent-disclosure-skill 中国专利.skill:专利点挖掘与交底书(发明/实用/外观)编写,通俗解读专利,嗅探政策动向,辅助审查答复。
|
10 | 13.5K | 2026-11-15 |