obsidian-skills — What is it?

The kepano/obsidian-skills project provides a suite of agent skills for Obsidian, enabling users to interact with Markdown, Bases, JSON Canvas, and the CLI, enhancing productivity and customization.

⭐ 33,990 Stars 🍴 2,398 Forks — — Author: kepano
Source: Official README and linked documentation View on GitHub →

Why it matters

This project is being discussed because its integration with popular tools like Claude Code, Codex, and OpenCode, addressing the need for advanced Markdown and data manipulation capabilities within Obsidian. Its adherence to the Agent Skills specification allows for compatibility with various agents, making it a versatile tool for users seeking to extend their Obsidian workflows.

Source: Official README and linked documentation

Core Features

obsidian-markdown

This skill allows for the creation and editing of Obsidian Flavored Markdown files, incorporating Obsidian-specific syntax and features.

Source: Official README and linked documentation
obsidian-bases

The obsidian-bases skill enables users to create and edit Bases, which are used for views, filters, formulas, and summaries in Obsidian.

Source: Official README and linked documentation
json-canvas

This skill supports the creation and editing of JSON Canvas files, facilitating the design of complex data visualizations and diagrams.

Source: Official README and linked documentation
obsidian-cli

The obsidian-cli skill allows users to interact with Obsidian vaults via the command line, supporting plugin and theme development.

Source: Official README and linked documentation
defuddle

This skill extracts clean Markdown from web pages using Defuddle, optimizing token usage and enhancing content quality.

Source: Official README and linked documentation
knap

The knap skill renders Markdown templates from JSON or CSV data, enabling batch file generation and data-driven content creation.

Source: Official README and linked documentation

Architecture

The project's architecture is modular, with each skill encapsulated in its own directory. This allows for easy maintenance and scalability. The code structure follows the Agent Skills specification, ensuring compatibility with various agents. The project does not rely on external dependencies, indicating a focus on simplicity and direct integration with Obsidian.

Source: Official repository tree and dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) Not enough information.Not enough inf… obsidian-markdown obsidian-bases json-canvas obsidian-cli defuddle knap obsidian-skills Project Core feature Key dependency

Tech Stack

LanguageNot enough information.FrameworkNot enough information.
Not enough information.
Not enough information.
Source: Official repository tree and dependency files

Quick Start

Marketplace: /plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills npx skills: npx skills add git@github.com:kepano/obsidian-skills.git Manually: Claude Code: Add the contents of this repo to a /.claude folder. Codex: Copy the skills/ directory into your Codex skills path. OpenCode: Clone the entire repo into the OpenCode skills directory.
Source: Official README and linked documentation

Use Cases

This project is suitable for users of Obsidian who require advanced Markdown and data manipulation capabilities. It is useful for content creators, developers, and anyone looking to enhance their Obsidian workflows with custom skills and automation.

Source: Official README and linked documentation

Strengths & Limitations

Strengths

  • Extensive range of skills for Obsidian
  • Compatibility with multiple agents
  • Easy to integrate and use

Limitations

  • Lack of detailed documentation
  • Limited information on the primary programming language and dependencies
Source: Official README and linked documentation

Latest Release

As of 2026-09-23, GitHub Releases shows no formal release. The repository is maintained on main. Reproducible use should pin a reviewed commit and inspect skill-text changes before upgrading.

Source: github.com/kepano/obsidian-skills/releases

Verification and evidence

status: docs-only  |  checked_at: 2026-09-23  |  environment: Docs only. Reviewed the official README, Releases, and the obsidian-cli and defuddle SKILL files.  |  limitations: npx was not executed, no skill was copied, Obsidian was not opened, no vault was read or written, and no CLI, Defuddle, Knap, or plugin-development command was run.  |  observed_output: GitHub Releases has no formal version. The README lists six skills and three installation paths. The CLI skill states that Obsidian must be running and uses the most recently focused vault by default.

Source: github.com/kepano/obsidian-skills/releases;https://github.com/kepano/…

Comparison

obsidian-skills supplies formatting and tool-operation instructions but does not impose a vault structure for people, projects, or decisions, nor does it include session hooks or a persistent-memory workflow. Obsidian Mind is a complete vault template that uses obsidian-skills and the CLI as components. Choose the skills when retaining an existing vault structure. Evaluate Obsidian Mind when adopting a full working-memory system.

Source: github.com/kepano/obsidian-skills/blob/main/README.md;https://github.…

Verdict

The kepano/obsidian-skills project is a tool for Obsidian users seeking to extend their capabilities with a suite of specialized skills. Its modular design and compatibility with various agents make it a versatile tool for enhancing productivity and customization within the Obsidian tooling.

Frequently Asked Questions

What did the documentation review verify for obsidian-skills on 2026-09-23?

GitHub Releases has no formal version. The README lists six skills and three installation paths. The CLI skill states that Obsidian must be running and uses the most recently focused vault by default.

What evidence boundary applies to this obsidian-skills review?

The review environment was: Docs only. Reviewed the official README, Releases, and the obsidian-cli and defuddle SKILL files. obsidian-skills behavior outside that scope still needs a local check.

Sources and review scope
This review is based on the project's public documentation. Versions, installation commands, and feature boundaries can change upstream; check the cited sources and current release before use. Sources checked on: 2026-09-23 13:55.

Reference materials: README, GitHub API, dependency files