Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

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

GitHub

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

Knowledge and rules for your assistantNothing to run: text files only

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.
Repositoryobsidianmd/obsidian-skills
GitHub stars52,679
Skills7
CategoryPlanning, memory and productivity
LicenseMIT
Last updatedNov 11, 2026 · card checked Nov 12, 2026 at commit 3981277
Install countsobsidianmd/obsidian-skills on skills.sh, Vercel's skills directory, which shows installs and security audits per skill

obsidianmd/obsidian-skills popularity over time

Most starred skill packs

obsidianmd/obsidian-skills: GitHub starstotal over time 52,679
obsidianmd/obsidian-skills: new stars per weekGitHub 1,550

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
Say: “Write a project note for Project Alpha with tags, a deadline callout and links to my meeting notes”

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
Say: “Create a reading list Base with a cards view and a table of books I still have to read”

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
Say: “Make a Canvas with three idea cards and labeled connections”

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
Say: “Find notes about my current project and summarize the open tasks”

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
Say: “Set up Obsidian Sync for my Research vault in ~/vaults/research”

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
Say: “Extract this public article into Markdown and save it as a note”

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
Say: “Use my Knap template and this CSV of articles to make one note per row in notes/”

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

From plugins/obsidian/skills/obsidian-bases/SKILL.md.

When to reach for it

You wantUse
Notes written with Obsidian links, callouts and propertiesobsidian-markdown
A table, card gallery or kanban board of your notesobsidian-bases
A board of connected ideas, a mind map or a flowchartjson-canvas
Search, read or reorganise notes in your vaultobsidian-cli (Obsidian app open)
Sync or publish a vault from a server or terminalobsidian-headless
A web article saved as a clean notedefuddle, then knap for a template
Many notes from one template and a spreadsheetknap
Try it. Install it, open Obsidian, and ask: "Create a reading list Base with table and card views from the books in my vault." A new .base file appears that opens in Obsidian as a table and a card gallery of your book notes.

Skills in obsidianmd/obsidian-skills

SkillIn plain wordsChanges files?What it does (author)
defuddle Turns a web page into clean text without menus and ads, to read or save as a noteYes 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 linksYes 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 rowYes 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 boardYes 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 themesYes 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 appYes 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 embedsYes 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

  1. 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
  2. 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
  3. Have an active Obsidian Sync or Publish subscription (https://obsidian.md/)
    Then: The assistant can sync or publish the vault
  4. Approve a global npm install of Defuddle, Knap or Obsidian Headless when the assistant asks (your terminal)
    Then: The assistant runs the missing tool
  5. 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 unrelated
  • Trust 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 fails
  • Pass 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 JSON
  • Run 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 conflicts
  • Write 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 needPick
You want the official formats and commands for notes, Bases, Canvas, the Obsidian CLI, Sync and PublishThis pack
You want an assistant that files and links everything you drop into a self-organising second brainAgriciDaniel/claude-obsidian
You want a vault that works as persistent memory for coding agentsbreferrari/obsidian-mind
You want Canvas, Excalidraw and Mermaid diagrams generated from textaxtonliu/axton-obsidian-visual-skills

Works well with

  • defuddle: The defuddle skill runs the Defuddle command to turn web pages into Markdown
  • obsidian: obsidian-cli has a reload, error and screenshot loop for building Obsidian plugins
  • mermaid: obsidian-markdown covers Mermaid diagrams inside notes

May I use it like this?

UseAnswerCondition
In a commercial app YesMIT
Work for clients YesMIT
Passing the files on YesMIT: keep the copyright and permission notice in copies
Shipped inside your app YesMIT: 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.

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

WhenWhat happens
InstallSeven 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 workTells 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 workTells your assistant to run Defuddle, which downloads the web page you name.
obsidian-headless at workTells your assistant to run ob, which syncs your vault with Obsidian Sync or uploads notes to Obsidian Publish.
A helper tool is missingThe 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

All planning, memory and productivity skills

# 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