explaingit

kepano/obsidian-skills

📈 Trending31,932Audience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

A set of AI agent skills that teach coding assistants how to work correctly with Obsidian notes, including its special Markdown syntax, databases, and canvas files.

Mindmap

mindmap
  root((repo))
    What it does
      Teaches AI assistants
      Works with Obsidian
      Handles Markdown syntax
    Skills included
      Obsidian Markdown
      Obsidian Bases
      JSON Canvas
      CLI interactions
      Defuddle tool
    Use cases
      Create notes correctly
      Edit vault content
      Organize information
      Build plugins
    Tech stack
      Agent Skills spec
      Markdown
      JSON
      CLI tools

Things people build with this

USE CASE 1

Prompt an AI assistant to create and format notes inside your Obsidian vault without syntax errors.

USE CASE 2

Have an AI tool automatically organize and link your notes using Obsidian's wikilink syntax.

USE CASE 3

Build Obsidian plugins and themes with AI assistance using the CLI skill.

USE CASE 4

Convert web content into clean Markdown notes using the Defuddle integration.

Tech stack

Agent Skills specificationMarkdownJSONObsidian CLIJavaScript

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

This repository is a set of agent skills for working with Obsidian, a note-taking application that stores notes as plain Markdown files. An agent skill is a structured set of instructions that tells an AI coding assistant, such as Claude Code or Codex CLI, how to perform a specific task correctly. The skills follow a published specification called the Agent Skills specification so they can be used by any compatible AI tool, not just one particular product. Five skills are included. One teaches the agent Obsidian's particular flavor of Markdown, which adds features like wikilinks (links written as double brackets), embeds, callouts, and note properties. Another covers Obsidian Bases, a database-like file format for creating filtered views and summaries over your notes. A third handles JSON Canvas, a file format for visual canvas layouts with connected nodes and groups. A fourth skill enables interacting with an Obsidian vault through the Obsidian command-line interface, useful for plugin and theme development. The fifth skill covers Defuddle, a separate tool that strips clutter from web pages and converts them to clean Markdown. You would use this repository if you work inside an Obsidian vault and want an AI assistant to create, edit, and organize your notes correctly without making mistakes specific to Obsidian's non-standard syntax. Installation can be done via a marketplace command, via npx, or by manually copying files into the configuration folder of whichever AI tool you use.

Copy-paste prompts

Prompt 1
Use the Obsidian skills to help me create a new note with proper wikilinks and callouts in my vault.
Prompt 2
I want to set up an Obsidian Base with filtered views, use these skills to generate the correct JSON structure.
Prompt 3
Help me build a visual canvas in Obsidian using JSON Canvas format with connected nodes and groups.
Prompt 4
Use the Obsidian CLI skill to help me develop a custom plugin that interacts with my vault.
Prompt 5
Convert this web article into a clean Markdown note for my Obsidian vault using the Defuddle skill.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.