kepano/obsidian-skills

⭐ 30,150  ·  None  ·  GitHub Repo

Agent skills for Obsidian. Teach your agent to use Markdown, Bases, JSON Canvas, and use the CLI.

claude clawdbot cli codex defuddle obsidian openclaw opencode

1-Sentence Summary

Teach AI coding agents to natively manage Obsidian vaults with standardized skills for Markdown, Bases, and CLI.

🔥 Key Capabilities & USP

• Obsidian Flavored Markdown Skill: Agents can create and edit .md files using wikilinks, embeds, callouts, and properties. Solves the pain of manually formatting complex Obsidian notes or writing custom prompts to teach agents Obsidian-specific syntax.
• Obsidian Bases Skill: Enables agents to create and edit .base files with views, filters, formulas, and summaries. Solves the challenge of programmatically managing structured data and database-like views within Obsidian.
• JSON Canvas Skill: Agents can create and edit .canvas files with nodes, edges, and groups. Solves the difficulty of generating or modifying visual knowledge graphs and mind maps programmatically.
• Obsidian CLI Skill: Provides agent capabilities for plugin/theme development and vault interaction via the CLI. Solves the friction of automating development workflows and vault operations without manual intervention.
• Defuddle Skill: Extracts clean markdown from web pages, removing clutter to save tokens. Solves the high token cost and noise when agents ingest web content for vault research.

USP: Platform-agnostic adherence to the Agent Skills specification, making it compatible with Claude Code, Codex CLI, and OpenCode out of the box—no vendor lock-in.

Technical Architecture

Component	Description
Skill Format	Individual skill directories under skills/ folder, each containing a SKILL.md file following the Agent Skills specification
Agent Platforms	Compatible with Claude Code, Codex CLI, OpenCode (and any platform supporting the spec)
Installation Methods	Marketplace plugin, npx CLI, or manual git clone
No Language Dependency	Language-agnostic; skills are defined as markdown instructions, not code
Extensibility	Modular design allows adding new skills without modifying existing ones

Quick Start Guide

Install via the Obsidian plugin marketplace:

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

Or install via npx (for Claude Code, Codex CLI):

npx skills add git@github.com:kepano/obsidian-skills.git
npx skills add https://github.com/kepano/obsidian-skills

Or manual installation for OpenCode:

git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

Pros, Cons & Use Cases

Pros

• Platform-agnostic: Works with multiple agent systems (Claude Code, Codex CLI, OpenCode)
• Open specification: Follows a community standard, ensuring future compatibility
• Comprehensive coverage: Addresses the most important Obsidian-specific formats (Markdown, Bases, Canvas, CLI)
• Zero code overhead: Skills are markdown-based instructions, not complex codebases
• Active ecosystem: 30,150 stars indicates strong community validation

Cons

• Requires agent environment: Not usable standalone; needs Claude Code, Codex CLI, or OpenCode
• Platform-specific setup: Installation steps vary by agent platform, adding initial friction
• No GUI: Entirely command-line and agent-driven; no visual interface for management
• Learning curve: Users must understand both Obsidian and the chosen agent system

Who should NOT use this?

• Non-Obsidian users: If you don't use Obsidian, this project provides no value.
• Users wanting a GUI: If you prefer visual tools over CLI/agent-driven workflows, this is not for you.
• Single-platform users: If you only use one agent system and don't plan to switch, simpler platform-specific solutions may suffice.
• Token-sensitive beginners: The agent ecosystem requires understanding of CLI tools and AI interaction patterns.

Ideal Use Cases

• Automated vault management: Batch create, edit, and organize notes with Obsidian-specific formatting.
• Knowledge base ingestion: Use Defuddle to scrape web content and automatically create well-structured Obsidian notes.
• Plugin/theme development: Use the CLI skill to automate Obsidian plugin builds, testing, and deployment.
• Visual canvas generation: Programmatically create complex mind maps and relationship diagrams via JSON Canvas.
• Team knowledge workflows: Standardize how AI agents interact with shared Obsidian vaults across multiple team members.

Community & Activity

With 30,150 stars and continuous updates (last updated May 10, 2026), this project has clearly struck a nerve in the Obsidian + AI community. The high star count reflects strong adoption and validation from both Obsidian power users and AI agent enthusiasts. The project is actively maintained and has become a de facto standard for integrating AI agents with Obsidian workflows. Given the rapid growth of agent-based tools, this project is well-positioned to become the canonical skill set for Obsidian-AI interaction.