Obsidian Skills
kepano/obsidian-skills
Obsidian Skills is a free, MIT-licensed set of 6 Agent Skills for working in an Obsidian vault, made by Steph Ango, known as kepano. They teach an agent Obsidian Flavored Markdown, Bases, JSON Canvas, the Obsidian CLI, and two helper tools for clean web extraction and template rendering. They follow the Agent Skills specification.
Facts checked on against the sources listed at the end of this page.
- GitHub stars
- 49,524
- Skills in the pack
- 6
- Agents supported
- 3named in the README
- License
- MIT
- Last commit
- 4 weeks ago15 September 2026
- Instruction size
- 4.9k wordsacross all SKILL.md files
How to install Obsidian Skills
| Agent | Command | Copy |
|---|---|---|
| Claude Code | | |
| Other agents | | |
| Codex | Copy the skills/ directory into your Codex skills path, typically ~/.codex/skills. | |
| OpenCode | Clone the whole repo, not just the inner skills folder. |
Commands as given in the README on 14 October 2026.
What Obsidian Skills runs on your machine
- Hooks
- None found in the repo.
- Bundled scripts
- None in the repo. The skills instruct the agent to use the Obsidian CLI, Defuddle and Knap, which you install separately.
- Network calls
- The defuddle skill fetches web pages you point it at. The other skills are Markdown instructions.
- API keys needed
- None named in the README.
These are facts read from the repo, not a security rating. Read the files before you install any skill.
What is inside Obsidian Skills
| Skill | What it makes the agent do |
|---|---|
| obsidian-markdown | Creates and edits Obsidian Flavored Markdown with wikilinks, embeds, callouts and properties. |
| obsidian-bases | Creates and edits .base files with views, filters, formulas and summaries. |
| json-canvas | Creates and edits .canvas files with nodes, edges and groups. |
| obsidian-cli | Works with vaults through the Obsidian CLI, including plugin and theme development. |
| defuddle | Extracts clean Markdown from web pages with Defuddle, removing clutter to save tokens. |
| knap | Renders Markdown templates from JSON or CSV data with Knap, including batch file generation. |
A good fit for
- Obsidian users who let an agent create or tidy notes in their vault
- People building Bases or Canvas files who want valid output on the first try
- Anyone who clips web pages into notes and wants less clutter in the agent's context
- Plugin and theme developers who use the Obsidian CLI
Skip it if
- Notes kept in tools other than Obsidian, since the syntax rules are Obsidian specific
- Users who want an agent to organize a whole vault by itself, because these skills teach formats and tools, not a filing system
How Obsidian Skills works
The point of the pack is correct file syntax. Obsidian has its own Markdown flavor and file formats for Bases and Canvas, and an agent that does not know them writes plain Markdown that Obsidian renders badly. Each skill carries the format rules for one of those.
For Claude Code, the README suggests putting the repo contents in a .claude folder at the root of your vault so the skills sit next to your notes.
- Made by
- Steph Ango (kepano)
- Topic
- Docs and writing
- Works with
- Claude Code, Codex, OpenCode
How much context Obsidian Skills uses
| All 6 skills | 4,862 words across every SKILL.md file |
|---|---|
| Largest skill | obsidian-bases, 1,776 words |
| Loaded at start | Only each skill's name and description. The full text loads when a task needs that skill. |
Word counts are measured from the repo every day. Reference files a skill loads on demand are not counted.
Is Obsidian Skills still maintained?
| Last commit | , 4 weeks ago |
|---|---|
| Stars gained in 7 days | Shown after 7 days of tracking |
| Stars gained in 30 days | Shown after 30 days of tracking |
| Open issues and pull requests | 75 |
| Forks | 3,511 |
Tools Obsidian Skills works with
Questions about Obsidian Skills
Does Obsidian Skills work with Codex and OpenCode?
Yes. The README gives manual steps for both, and the skills follow the Agent Skills specification.
Do I need to install anything else?
The obsidian-cli, defuddle and knap skills rely on the Obsidian CLI, Defuddle and Knap respectively. The other three skills need nothing extra.
Is it free?
Yes. It is MIT licensed.
Who makes it?
Steph Ango, who goes by kepano on GitHub. The pack is community made, not an official Obsidian product.
Sources
- kepano/obsidian-skills on GitHub
- Obsidian Skills README
- obsidian-markdown skill
- Obsidian Skills license
Something wrong or out of date? Email [email protected] with a link to the source. Stats come from the public GitHub API and update every day.
For the maker
Add the badge to your README or site. The number updates every day.
Sharing on X? Open the share card with the pack's live numbers.
