Repolode
Submit
kepano

kepano/obsidian-skills

A set of Agent Skills that teach AI coding agents to work with Obsidian vaults and open formats like Markdown, Bases, and JSON Canvas.

View on GitHub
Stars
49,830
Forks
3,526
Open issues
74
Last commit
last month

What is it?

obsidian-skills is a collection of Agent Skills for Obsidian, the note-taking app built on local Markdown files. Each skill is a SKILL.md instruction set that lets an AI agent such as Claude Code, Codex, or OpenCode create and edit Obsidian-specific files correctly, instead of guessing at the syntax.

The package covers six areas: Obsidian Flavored Markdown with wikilinks, embeds, callouts and properties; Obsidian Bases (.base) files with views, filters, formulas and summaries; JSON Canvas (.canvas) files with nodes, edges and groups; the Obsidian CLI for interacting with vaults, including plugin and theme development; Defuddle for extracting clean Markdown from web pages; and Knap for rendering Markdown templates from JSON or CSV data.

The skills follow the Agent Skills specification and can be installed through a plugin marketplace, the npx skills tool, or by manually copying the files into an agent's skills directory.

Key features

  • 01Teaches agents Obsidian Flavored Markdown syntax such as wikilinks, embeds, callouts and properties.
  • 02Covers creating and editing Obsidian Bases (.base) files with views, filters and formulas.
  • 03Supports JSON Canvas (.canvas) files with nodes, edges and groups.
  • 04Includes guidance for the Obsidian CLI, including plugin and theme development.
  • 05Provides Defuddle for extracting clean Markdown from web pages.
  • 06Follows the Agent Skills specification and installs into Claude Code, Codex and OpenCode.

Use cases

  • Letting an AI agent write or refactor notes in an Obsidian vault with correct links and properties.
  • Generating Canvas diagrams or Bases database views from an agent prompt.
  • Clipping web articles into clean Markdown notes for a personal knowledge base.
  • Rendering batch documents from JSON or CSV data using Markdown templates.

Quick start

  1. 1

    Add the marketplace in Claude Code

    /plugin marketplace add kepano/obsidian-skills
  2. 2

    Install the Obsidian plugin from the marketplace

    /plugin install obsidian@obsidian-skills

Topics

#obsidian#agent-skills#markdown#ai-agent#note-taking#json-canvas#claude-code#cli#agents#agentskills

FAQ

What is obsidian-skills?
A set of Agent Skills that teach AI coding agents to work with Obsidian vaults and open formats like Markdown, Bases, and JSON Canvas. obsidian-skills is a collection of Agent Skills for Obsidian, the note-taking app built on local Markdown files. Each skill is a SKILL.md instruction set that lets an AI agent such as Claude Code, Codex, or OpenCode create and edit Obsidian-specific files correctly, instead of guessing at the syntax.
Is obsidian-skills free to use? What license does it have?
obsidian-skills is open source under the MIT license. Check the license terms before using it in commercial products.
Is obsidian-skills still maintained?
Updated within 6 months. The last commit to obsidian-skills was on Sep 15, 2026.
What can I use obsidian-skills for?
Letting an AI agent write or refactor notes in an Obsidian vault with correct links and properties. Generating Canvas diagrams or Bases database views from an agent prompt. Clipping web articles into clean Markdown notes for a personal knowledge base. Rendering batch documents from JSON or CSV data using Markdown templates.
How do I install obsidian-skills?
Add the marketplace in Claude Code: /plugin marketplace add kepano/obsidian-skills Install the Obsidian plugin from the marketplace: /plugin install obsidian@obsidian-skills
Where can I get obsidian-skills?
The source code and installation instructions are on GitHub: https://github.com/kepano/obsidian-skills

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects