$ show kepano/obsidian-skills
This repository is a collection of Agent Skills for AI coding assistants (Claude Code, Codex, OpenCode) that enables them to interact with Obsidian vaults. It contains six skill definitions: obsidian-markdown (creating Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties), obsidian-bases (creating database-like .base files with views, filters, formulas), json-canvas (creating visual .canvas files with nodes and edges), obsidian-cli (interacting with Obsidian via CLI for note management and plugin development), defuddle (extracting clean markdown from web pages), and knap (rendering Markdown templates from structured data). Each skill is a self-contained markdown file following the Agent Skills specification, providing detailed syntax, examples, and validation steps. The repository is purely documentation with no executable code, serving as a knowledge base that AI agents use to perform Obsidian-related tasks on behalf of users.
The LLM identified 6 files worth highlighting for reuse:
Comprehensive guide for AI agents to create and edit Obsidian Flavored Markdown files. Covers wikilinks, embeds, callouts, properties (frontmatter), tags, comments, math, diagrams, and footnotes. Includes workflow for creating notes, validation steps, and references to detailed sub-documents. Reusable as a standalone skill for any agent needing to generate Obsidian-compatible markdown.
Complete specification for creating and editing Obsidian Bases (.base files) which provide database-like views of notes. Defines YAML schema for filters (with AND/OR/NOT logic), formulas (with arithmetic, conditionals, date operations), properties, summaries, and multiple view types (table, cards, list, map). Includes troubleshooting for YAML quoting and common formula errors. Reusable for any agent needing to generate structured data views.
Detailed instructions for creating and editing JSON Canvas files (.canvas) with nodes (text, file, link, group) and edges. Covers ID generation, layout guidelines, color presets, and a validation checklist. Includes common workflows for creating canvases, adding nodes, connecting nodes, and editing. Reusable for any agent needing to generate visual mind maps or flowcharts in JSON Canvas format.
Guide for using the Obsidian CLI to interact with a running Obsidian instance. Covers file targeting, vault targeting, common patterns (read, create, append, search, tasks, tags, backlinks), and a plugin development workflow (reload, check errors, screenshot, DOM inspection, console). Reusable for any agent needing to automate Obsidian operations or assist with plugin/theme development.
Instructions for using Defuddle CLI to extract clean markdown from web pages, removing clutter to save tokens. Specifies usage with --md flag, saving to file, extracting metadata, and output formats. Includes a pipeline combining Defuddle with Knap for note creation. Reusable for any agent needing to fetch and clean web content for note-taking.
Guide for using Knap CLI to render Markdown templates from JSON/CSV data. Covers template syntax (variables, filters, logic), validation, batch rendering with filename templates, and integration with Defuddle for web-to-note pipelines. Reusable for any agent needing to generate structured notes from data sources.