SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsobsidian-skills-integrated

obsidian-skills-integrated

Data & analytics

View repository

Updated 10-15 19:56

About this skill

Obsidian Skills - Official Knowledge Management Skill Set

Introduction

An official skill set open-sourced by Obsidian CEO Steph Ango (kepano), providing AI Agents with professional Obsidian operation capabilities.

Project URL: https://github.com/kepano/obsidian-skills
GitHub Star: 9.4k+
Open Source License: MIT License
Technical Specification: Follows Agent Skills specification

Core Value

✅ Official Endorsement - Personally developed by the Obsidian CEO, with guaranteed quality and compatibility
✅ Filling the Gap - Adds professional knowledge management capabilities to the local skill library
✅ Standard Specification - Follows the Agent Skills specification, easy to integrate and maintain
✅ Collaborative Enhancement - Forms a complete workflow loop with existing skills

Included Skills

1. obsidian-markdown

Function: Handles Obsidian-exclusive Markdown syntax

Core Capabilities:

  • ✅ Bidirectional Links (Wikilinks): [[笔记名称]]
  • ✅ Content Embed (Embed): ![[文件名]]
  • ✅ Callouts: > [!INFO]
  • ✅ Properties/Frontmatter: YAML format
  • ✅ Tag System: #标签名
  • ✅ Mathematical Formulas: LaTeX syntax
  • ✅ Diagram Support: Mermaid, etc.

Pain Point Solved: General AI models often break Obsidian-exclusive syntax, causing wikilinks to fail, Callout formats to become corrupted, and Frontmatter to be accidentally deleted.

2. json-canvas

Function: Creates and edits Obsidian Canvas canvas files

Core Capabilities:

  • ✅ Multiple Node Types: text/file/link/group nodes
  • ✅ Edges: Establish relationships between nodes
  • ✅ Precise Positioning: x/y coordinates, z-index layering
  • ✅ Color Identification: Hexadecimal color support
  • ✅ Format Validation: Strict JSON structure validation

Application Scenarios: Mind maps, knowledge graphs, flowcharts, project boards.

3. obsidian-bases

Function: Operates Obsidian 1.9+ native databases

Core Capabilities:

  • ✅ View Management: Create and edit multiple view types
  • ✅ Filters: Complex conditional filtering
  • ✅ Formula System: Correct function call syntax
  • ✅ Summaries: Data statistics and aggregation

Pain Point Solved: AI-generated database formulas "look correct but won't run," and filter syntax errors cause views to fail.

Quick Start

Example 1: Create a Note

请用 obsidian-markdown 创建一篇关于"人工智能发展史"的笔记，包含：
- 双链引用相关概念
- 使用 INFO Callout 标注重点
- 添加 tags 和 date 元数据

Example 2: Generate a Mind Map

请用 json-canvas 生成《三国演义》人物关系图，包含：
- 主要人物节点（刘备、关羽、张飞、曹操、孙权等）
- 关系连接线（结义、对抗、联盟）
- 按势力分组并用颜色区分

Example 3: Create a Database

请用 obsidian-bases 创建一个读书清单数据库，包含：
- 字段：书名、作者、评分、状态、阅读日期
- 视图：按评分排序
- 过滤器：仅显示已读书籍

Version Requirements

  • Obsidian 1.0+: obsidian-markdown, json-canvas
  • Obsidian 1.9+: obsidian-bases (database functionality)

Recommendation: Upgrade to the latest version of Obsidian to get full feature support.

Collaboration with Other Skills

Workflow 1: Full Content Creation Process

obsidian-markdown (创建笔记)
    ↓
article-illustrator (自动配图)
    ↓
baoyu-post-to-wechat (发布到公众号)

Implementation Points:

  • article-illustrator uses Obsidian syntax when outputting images: ![[image.png]]
  • Automatically convert Obsidian-exclusive syntax to the target platform format before publishing

Workflow 2: Knowledge Visualization

obsidian-markdown (结构化笔记)
    ↓
json-canvas (知识图谱)
    ↓
ppt-generator (演示文稿)

Implementation Points:

  • json-canvas quickly generates knowledge networks
  • ppt-generator supports reading Canvas as an input source

Workflow 3: Project Management

obsidian-bases (项目数据库)
    ↓
json-canvas (项目看板)
    ↓
intelligent-content-system (报告生成)

Implementation Points:

  • obsidian-bases manages tasks, progress, and resources
  • json-canvas visualizes project status
  • intelligent-content-system automatically generates project reports

Potential Conflicts and Solutions

Conflict 1: baoyu-format-markdown formatting conflict ⚠️

Problem: baoyu-format-markdown may break Obsidian-specific syntax (wikilinks/Callout/Frontmatter)

Solution:

  • Inside an Obsidian vault: prefer using obsidian-markdown
  • External documents: use baoyu-format-markdown
  • Basis for judgment: detect whether the file path is inside an Obsidian vault

Conflict 2: ai-drawio feature overlap 🔄

Problem: json-canvas and ai-drawio can both generate visual charts

Solution: keep both, divided by scenario

  • Knowledge graphs/mind maps → json-canvas (Obsidian native, seamless integration)
  • Complex technical flowcharts → ai-drawio (professional tool, more powerful)

Usage Recommendations

Best Practices

  1. ✅ When working inside an Obsidian vault, always use obsidian-skills
  2. ✅ Clarify format requirements before creating notes (tags, Callout types, etc.)
  3. ✅ Do a single-file test before batch operations to avoid format issues
  4. ✅ Update skills regularly to stay compatible with Obsidian versions

Notes

  • ⚠️ obsidian-bases requires Obsidian 1.9+, users on older versions cannot use it
  • ⚠️ Generated .canvas files need to be opened in Obsidian for viewing
  • ⚠️ Avoid using these skills outside Obsidian environments (limited value)

Follow-up Maintenance

Version Synchronization

cd D:\tool\skills\obsidian-skills-integrated
# 下载最新版本
Invoke-WebRequest -Uri "https://github.com/kepano/obsidian-skills/archive/refs/heads/main.zip" -OutFile "update.zip"
# 解压并更新
Expand-Archive -Path "update.zip" -DestinationPath "temp" -Force
# 手动对比更新内容

Recommended frequency: check for updates once a month

Channels to Follow

Reference Resources

Official Documentation

Community Resources

Skill Comparison

Skill Feature Area Output Format Obsidian Integration Usage Priority
obsidian-markdown Markdown processing .md Native support ⭐⭐⭐⭐⭐
json-canvas Visualization .canvas Native support ⭐⭐⭐⭐⭐
obsidian-bases Database .base Native support ⭐⭐⭐⭐
baoyu-format-markdown Markdown formatting .md Potential conflict ⭐⭐⭐
ai-drawio Flowchart .drawio Requires export ⭐⭐⭐
article-illustrator Illustrations Images Collaborative enhancement ⭐⭐⭐⭐
ppt-generator Presentations .pptx Collaborative enhancement ⭐⭐⭐

Frequently Asked Questions

Q1: What should I do if it conflicts with existing skills?

A: Use it in isolated scenarios; prioritize obsidian-skills within an Obsidian vault, and use other skills for external documents.

Q2: Is it necessary to integrate if not using Obsidian?

A: Not recommended. These skills are designed specifically for Obsidian and have limited value outside Obsidian.

Q3: How do I update to the latest version?

A: Download the latest version from GitHub monthly, manually compare the update contents, and then replace the files.

Q4: Can I integrate only some of the skills?

A: Yes. It is recommended to integrate at least obsidian-markdown + json-canvas; obsidian-bases is optional (requires Obsidian 1.9+).

Q5: Where can I view the generated files?

A:

  • .md files: any text editor or Obsidian
  • .canvas files: must be opened in Obsidian
  • .base files: must be opened in Obsidian 1.9+

Summary

Core advantages

✅ Official authority - Developed personally by the Obsidian CEO, 9.4k+ Stars
✅ Feature complete - Covers the three core scenarios: notes, visualization, and databases
✅ Standard specification - Follows the Agent Skills specification, easy to maintain
✅ Collaborative enhancement - Forms a complete workflow with existing skills

Suitable audience

  • ✅ Obsidian power users
  • ✅ Knowledge management enthusiasts
  • ✅ Content creators
  • ✅ Project managers

Expected benefits

  • 📝 Note management efficiency increased 10x
  • 🎨 Knowledge visualization time reduced 90%
  • 🔗 Complete closed loop for the content creation workflow
  • 🚀 A qualitative leap in the overall capability of the skill library

Integration completion time: 2026-02-09
Skill version: Based on the GitHub main branch
Next update suggestion: 2026-03-09 (one month later)
Maintenance status: ✅ Integrated, regularly updated