Obsidian Skills
github.com/kepano/obsidian-skills- Category
- AI Agents
- Rank
- No. 174Tools index
Previous survey · No. 187 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- @kepano
- GitHub
- 48.5k stars
- Date
About
A collection of agent skills that teach AI agents to work with Obsidian vaults, including creating and editing Markdown files, Bases, JSON Canvas, and using the CLI. Compatible with Claude Code, Codex CLI, and other skills-compatible agents following the Agent Skills specification.
What it does
Obsidian Skills supplies detailed operating playbooks that an AI agent can load when handling a vault. The playbooks explain Obsidian syntax, data shapes, validation steps, layout rules, command-line workflows, and web-page cleanup, with worked examples for common note, database-style view, and visual canvas tasks.
Why it's ranked here
The material is operational rather than merely descriptive. It documents required fields, quoting hazards, reference integrity, layout conventions, and verification steps. That makes it useful for reducing plausible-looking but invalid output. Correctness still depends on the agent following those checks and, for some work, testing the result inside Obsidian.
What's good
Each area gets domain-specific guidance. Markdown coverage explains links, embeds, properties, callouts, tags, math, and diagrams. Canvas guidance specifies node types, edge integrity, unique identifiers, spacing, and validation. Bases coverage includes filters, formulas, summaries, views, date arithmetic, quoting mistakes, and substantial examples. The command-line guidance also covers plugin debugging, screenshots, console errors, and DOM inspection.
Tradeoffs
These are instructions for an existing AI agent, so results depend on that agent applying them correctly. Command-line vault operations require Obsidian to be open. Web extraction requires Defuddle to be installed separately. Some outcomes still need visual confirmation inside Obsidian, and map views depend on a community plugin.
How to use it well
Use it when an agent regularly maintains an Obsidian vault, generates structured Bases, builds canvases, or supports plugin and theme development. Pair generation with the supplied validation checklists and open complex results in Obsidian before trusting them. It does not replace the Obsidian application, and web cleanup remains a separate command-line dependency.
Technical notes+
README.md defines marketplace, npx, and manual installation for Claude Code, Codex, and OpenCode. .claude-plugin/plugin.json and .claude-plugin/marketplace.json provide Claude plugin packaging. Each capability is instruction-driven through skills/*/SKILL.md; skills/json-canvas/SKILL.md specifies JSON Canvas structure and integrity checks, while skills/obsidian-bases/SKILL.md documents YAML schemas, formulas, and views. skills/obsidian-cli/SKILL.md invokes the external obsidian CLI and requires a running Obsidian instance. skills/defuddle/SKILL.md invokes a separately installed Defuddle CLI. Reference material is split into files such as skills/json-canvas/references/EXAMPLES.md and skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md.
Observed
- License
- MIT License
- Primary content
- Markdown skill documentation with YAML frontmatter, plus JSON plugin metadata
- Install surface
- Claude marketplace commands, npx skills, and manual installation are documented
- Agent support
- Claude Code, Codex, and OpenCode are explicitly supported
- Interface
- Agent Skills documents plus workflows using the Obsidian and Defuddle command-line tools
- Skill structure
- Five named skills cover Obsidian Markdown, Bases, JSON Canvas, Obsidian CLI workflows, and web-page extraction
- Runtime requirement
- Obsidian CLI workflows require Obsidian to be open
Read from README.md, LICENSE, .claude-plugin/plugin.json, .claude-plugin/marketplace.json, skills/defuddle/SKILL.md, skills/json-canvas/SKILL.md, skills/obsidian-cli/SKILL.md, skills/obsidian-bases/SKILL.md, skills/obsidian-markdown/SKILL.md, skills/json-canvas/references/EXAMPLES.md, skills/obsidian-markdown/references/EMBEDS.md, skills/obsidian-markdown/references/CALLOUTS.md, skills/obsidian-markdown/references/PROPERTIES.md, skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md.
What it can do
Create Obsidian Flavored Markdown files
Content and formatting instructions → Obsidian-compatible Markdown files
Edit existing Markdown files in Obsidian vaults
Existing Markdown files and modification instructions → Updated Markdown files
Create Obsidian Bases
Base structure and content specifications → Obsidian Base files
Generate JSON Canvas files
Canvas layout and node specifications → JSON Canvas files for Obsidian
Execute Obsidian CLI commands
CLI command parameters and vault references → Command execution results and vault modifications
Train AI agents to work with Obsidian vaults
Agent specifications and Obsidian workflow requirements → Configured AI agents with Obsidian skills
Tags
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.