
kepano/obsidian-skills teaches Claude Code, Codex, OpenCode, and Hermes-compatible agents how to work with Obsidian Markdown, Bases, JSON Canvas, Obsidian CLI, and Defuddle. Install it if your vault is already a working system; skip it if you need a fully defined personal workflow or smooth support across rough-edge environments.
kepano/obsidian-skills if your agent already works inside an Obsidian vault. Skip it if you want a finished personal knowledge-management workflow out of the box.kepano), Obsidian's CEO; the June 28 snapshot shows 38.7K stars, 2.7K forks, 46 commits, and an MIT license. 1 The sharper signal is the scope: it teaches agents how to handle Obsidian Markdown, Bases, JSON Canvas, Obsidian CLI, and Defuddle rather than giving them generic note-taking advice. 1npx skills, Codex directory copying, and OpenCode cloning paths documented in the repo. 1obsidian-cli, a way to operate a running Obsidian app. It does not know your folder taxonomy, naming rules, tag discipline, review cadence, or private conventions unless you write those instructions yourself. A Chinese user, Bozhou, compared the official skills to a livable but unfinished shell: the structure is there, but the user still has to furnish the workflow. 2obsidian-skills contains five skills. obsidian-markdown covers Obsidian-flavored Markdown: wikilinks such as [[Note]], embedded notes and files with ![[...]], callouts, YAML properties, tags, comments, highlights, LaTeX math, Mermaid diagrams, and footnotes. 3 That is the part you want when an agent keeps writing clean Markdown that still misses Obsidian's native linking model.obsidian-bases teaches .base YAML files. It covers global and view-level filters, nested and/or/not logic, formulas, table/card/list/map views, summary formulas, and common failure modes such as Duration math without .days, missing null checks, and strict YAML quoting. 4 This is the skill to test if you want an agent to turn a natural-language request into a structured reading list, project dashboard, or CRM-style note view.json-canvas covers the JSON Canvas 1.0 format, including text, file, link, and group nodes; edge anchors; arrow endpoints; labels; color presets; 16-character hex IDs; and validation checks for unique IDs and complete edge references. 5 defuddle adds web-page extraction through the Defuddle CLI, with commands such as defuddle parse <url> --md, --json, output-file saving, and metadata extraction for title, description, and domain. 6obsidian-cli. The skill documents file operations such as read, create, append, search, daily:read, daily:append, tasks, tags, backlinks, and property:set; it also covers plugin-development commands such as plugin:reload, dev:errors, dev:screenshot, dev:dom, dev:console, and JavaScript eval against the running app context. 7 That is powerful because it moves the agent from "edit files on disk" to "interact with the running Obsidian instance." It also increases the blast radius of a bad instruction.npx skills add https://github.com/kepano/obsidian-skillsnpx skills add git@github.com:kepano/obsidian-skills.git. 1/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills.claude path, Codex skills/ directory path, and OpenCode clone path are all listed in the repository instructions. 1 OpenCode users should note the repo-level clone pattern: the documented path is git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills, not a copy of only one subdirectory. 1obsidian-markdown without giving the agent broad vault permissions. 3Use the obsidian-markdown skill.
Create a note called "Agent Skills inbox" with YAML properties for status, source, and created date.
Link it to [[AI tools]] and [[Obsidian workflows]].
Add one warning callout about reviewing agent-generated links before publishing.obsidian-bases with a narrow, inspectable view. The skill supports filters, formulas, table/card/list/map views, and summary formulas, so a good first prompt should ask for one view and a small number of fields. 4Use the obsidian-bases skill.
Create a .base file for notes tagged #agent-skill.
Show title, status, source, and file.mtime.
Sort by file.mtime descending and add a summary count by status.json-canvas only after you have a clear map in mind. The skill can generate .canvas files with text, file, link, and group nodes, plus validated edges and IDs. 5 A useful first request is a small two-cluster map, such as "tools I use" and "workflows they support," rather than a sprawling second brain diagram.obsidian-cli as the advanced path. It requires Obsidian to be running and supports both normal vault operations and developer commands against the app. 7 If you test it, ask the agent to read before it writes, operate on one named vault, and summarize the exact command it plans to run.obsidian-cli, WSL stdout behavior, headless Linux support through Xvfb and DISPLAY, and missing documentation for Bases sorting and embedded Bases code blocks. 14 Those are not reasons to avoid the pack entirely, but they are reasons to test it on a copy of your vault before you let it rewrite live notes..md, .base, .canvas, CLI commands, and clean web extraction; they do not infer which notes are canonical, which folders are archival, or which tags you want retired. 1 Add a small vault policy file before heavy use: allowed folders, forbidden folders, naming convention, tag rules, and a "read before write" rule.| Repository | kepano/obsidian-skills 1 |
| Maintainer | Steph Ango / kepano, Obsidian CEO 1 |
| License | MIT 1 |
| Snapshot metrics | 38.7K stars · 2.7K forks · 46 commits 1 |
| Included skills | obsidian-markdown, obsidian-bases, json-canvas, obsidian-cli, defuddle 1 |
| Supported agents | Claude Code, Codex, OpenCode, Hermes 1 |
| Main install command | npx skills add https://github.com/kepano/obsidian-skills 1 |
| Best first test | Create one linked Markdown note, then one .base view, before trying CLI writes. 34 |
github.com
github.com
github.com
github.com
github.com
github.com
medium.com
github.com
github.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.