Git Analytics Skills & MCPSkills & MCP
obsidianmd/obsidian-skills

obsidian-skills — ชุด Agent Skills สำหรับ Obsidian ที่ใช้ได้กับ Claude Code, Codex และ AI Agent อื่น ๆobsidian-skills — Agent Skills for Obsidian usable with Claude Code, Codex, and other AI agents

Skills & MCPSkills & MCP 52,536 ดาวStars 3,741 Shell MIT อัปเดตล่าสุดLast push 11 พ.ย. 256911 Nov 2026
obsidianmd/obsidian-skills

ชุด skill สำหรับสอน AI agent ให้สร้างและจัดการไฟล์ Obsidian ได้ ทั้ง Markdown, Bases, JSON Canvas และ CLI โดยทำตามมาตรฐาน Agent Skills specification ใช้ได้กับ Claude Code, Codex, Cursor และ OpenCode

A collection of skills that teach AI agents to create and manage Obsidian files — Markdown, Bases, JSON Canvas, and CLI — following the Agent Skills specification, compatible with Claude Code, Codex, Cursor, and OpenCode.

ไว้ทำอะไร

เมื่อใช้ AI coding agent อย่าง Claude Code หรือ Codex ตัว agent จะไม่รู้จักรูปแบบเฉพาะของ Obsidian เช่น wikilinks, callouts, Bases syntax หรือ JSON Canvas ทำให้สร้างหรือแก้ไฟล์ได้ไม่ถูกต้อง obsidian-skills แก้ปัญหานี้โดยให้ชุดคำสั่ง (skills) ที่สอน agent ให้เข้าใจ format เหล่านี้ รวมถึงการใช้ Obsidian CLI สำหรับจัดการ vault, sync และ publish จาก command line เหมาะสำหรับคนที่ใช้ Obsidian เป็น knowledge base และต้องการให้ AI agent ช่วยสร้าง แก้ไข หรือจัดการ vault อัตโนมัติ

ทำงานอย่างไร

โปรเจกต์นี้ทำตามมาตรฐาน Agent Skills specification (agentskills.io) โดยแต่ละ skill เป็นไฟล์ SKILL.md ที่อธิบายให้ AI agent รู้ว่าต้องทำอะไรและใช้คำสั่งอะไร เมื่อ agent โหลด skill เข้าไปจะได้รับ context เกี่ยวกับ syntax, format และ CLI commands ที่ถูกต้อง

ตัวอย่างเช่น skill 'defuddle' สอน agent ให้ใช้คำสั่ง `defuddle parse <url> --md` เพื่อดึง clean Markdown จากหน้าเว็บ โดยมีคำแนะนำให้ตรวจสอบว่า CLI พร้อมใช้งานก่อน และเสนอการติดตั้งถ้ายังไม่มี

การติดตั้งทำได้หลายวิธี ตั้งแต่ใช้ marketplace ของ Claude Code/Codex/Cursor ไปจนถึง npx skills หรือ copy ไฟล์ไปวางในโฟลเดอร์ skills ด้วยตนเอง ระบบ plugin marketplace ใช้ไฟล์ manifest (marketplace.json) ใน .claude-plugin/ และ .cursor-plugin/ เพื่อลงทะเบียน

มี script bump.sh สำหรับอัปเดตเวอร์ชันใน manifest ทุกไฟล์พร้อมกัน รองรับ semantic versioning (major, minor, patch)

โครงสร้างโค้ด

  • plugins/obsidian/skills/ — โฟลเดอร์หลักเก็บ skill ทั้ง 7 ตัว แต่ละ skill มีไฟล์ SKILL.md อธิบายวิธีใช้งานสำหรับ AI agent
  • .claude-plugin/marketplace.json — manifest สำหรับลงทะเบียนใน Claude Code marketplace
  • .cursor-plugin/marketplace.json — manifest สำหรับลงทะเบียนใน Cursor marketplace
  • .agents/plugins — โฟลเดอร์ config สำหรับ agent plugin system
  • scripts/bump.sh — Shell script สำหรับอัปเดตเวอร์ชันใน manifest ทั้งหมดพร้อมกัน (semantic versioning)

เริ่มใช้งาน

# Claude Code — from terminal
claude plugin marketplace add obsidianmd/obsidian-skills
claude plugin install obsidian@obsidian-skills

# Or via npx skills
npx skills add https://github.com/obsidianmd/obsidian-skills

# Codex
codex plugin marketplace add obsidianmd/obsidian-skills

# Manual — copy skills to your Claude Code project
cp -r plugins/obsidian/skills/ .claude/skills/

เหมาะกับงานแบบไหน

  • ใช้ Claude Code สร้างและแก้ไข Obsidian Markdown พร้อม wikilinks, callouts และ properties ได้ถูกต้อง
  • สั่ง AI agent สร้างไฟล์ Obsidian Bases (.base) พร้อม views, filters และ formulas
  • ให้ agent สร้าง JSON Canvas (.canvas) เพื่อจัดวาง mind map หรือ knowledge graph
  • ใช้ Obsidian CLI ผ่าน agent เพื่อจัดการ vault, ติดตั้ง plugin หรือพัฒนา theme
  • ดึง clean Markdown จากหน้าเว็บด้วย Defuddle เพื่อบันทึกลง vault อัตโนมัติ
  • ใช้ Knap render Markdown templates จาก JSON/CSV data เพื่อสร้างไฟล์จำนวนมากใน vault
  • Sync และ publish vault จาก command line ด้วย Obsidian Headless โดยไม่ต้องเปิด desktop app

ข้อควรรู้

  • ใช้ได้ฟรีภายใต้ MIT license
  • ต้องมี AI agent ที่รองรับ Agent Skills specification (Claude Code, Codex, Cursor, OpenCode) จึงจะใช้งานได้
  • บาง skill ต้องติดตั้ง CLI เพิ่ม เช่น Defuddle ต้อง npm install -g defuddle และ Obsidian CLI/Headless ต้องติดตั้งแยก
  • ภาษาหลักของโปรเจกต์เป็น Shell script และ Markdown ไม่มี runtime code — เป็นเพียงคำแนะนำสำหรับ agent
  • Skill เป็น static instruction ไม่ได้อัปเดตตาม Obsidian version อัตโนมัติ ต้อง update plugin เมื่อ Obsidian เปลี่ยน syntax

What it is for

AI coding agents like Claude Code or Codex don't natively understand Obsidian-specific formats such as wikilinks, callouts, Bases syntax, or JSON Canvas, leading to incorrect file generation. obsidian-skills solves this by providing skill definitions that teach agents these formats, plus Obsidian CLI usage for vault management, sync, and publish from the command line. It's designed for users who rely on Obsidian as a knowledge base and want AI agents to automate vault creation and editing.

How it works

The project follows the Agent Skills specification (agentskills.io). Each skill is a SKILL.md file containing instructions that teach an AI agent the correct syntax, format, and CLI commands for a specific Obsidian feature. When an agent loads a skill, it gains context about how to properly handle that file type.

For example, the 'defuddle' skill teaches the agent to use `defuddle parse <url> --md` to extract clean Markdown from web pages, with instructions to verify CLI availability first and offer installation if missing.

Installation supports multiple methods: Claude Code/Codex/Cursor marketplaces, npx skills, or manual file copy into the agent's skills directory. Plugin marketplace registration uses manifest files (marketplace.json) in .claude-plugin/ and .cursor-plugin/ directories.

A bump.sh script handles version updates across all manifest files simultaneously, supporting semantic versioning (major, minor, patch).

Code structure

  • plugins/obsidian/skills/ — Main directory containing all 7 skills, each with a SKILL.md file describing usage for AI agents
  • .claude-plugin/marketplace.json — Manifest for Claude Code marketplace registration
  • .cursor-plugin/marketplace.json — Manifest for Cursor marketplace registration
  • .agents/plugins — Configuration directory for the agent plugin system
  • scripts/bump.sh — Shell script for batch-updating versions across all manifests (semantic versioning)

Getting started

# Claude Code — from terminal
claude plugin marketplace add obsidianmd/obsidian-skills
claude plugin install obsidian@obsidian-skills

# Or via npx skills
npx skills add https://github.com/obsidianmd/obsidian-skills

# Codex
codex plugin marketplace add obsidianmd/obsidian-skills

# Manual — copy skills to your Claude Code project
cp -r plugins/obsidian/skills/ .claude/skills/

Good fit for

  • Use Claude Code to correctly create and edit Obsidian Markdown with wikilinks, callouts, and properties
  • Have an AI agent generate Obsidian Bases (.base) files with views, filters, and formulas
  • Let the agent create JSON Canvas (.canvas) files for mind maps or knowledge graphs
  • Manage vaults, install plugins, or develop themes via Obsidian CLI through an agent
  • Extract clean Markdown from web pages using Defuddle to automatically save into a vault
  • Use Knap to render Markdown templates from JSON/CSV data for batch file generation in a vault
  • Sync and publish vaults from the command line with Obsidian Headless without the desktop app

Things to know

  • Free to use under MIT license
  • Requires an AI agent that supports the Agent Skills specification (Claude Code, Codex, Cursor, OpenCode)
  • Some skills require additional CLI tools — e.g., Defuddle needs npm install -g defuddle, and Obsidian CLI/Headless must be installed separately
  • The project consists of Shell scripts and Markdown only — no runtime code, just instructions for agents
  • Skills are static instructions and don't auto-update with Obsidian versions; plugin updates are needed when Obsidian changes syntax

บทวิเคราะห์นี้สร้างจาก README และโค้ดของ repo โดย AI ของ Oneable — ตรวจสอบ license และเอกสารต้นทางก่อนนำไปใช้งานจริงThis breakdown was generated from the repository's README and code by Oneable's AI — check the license and upstream docs before using it in production.

#agents#agentskills#bases#chatgpt#claude#claude-code#claude-skills#cli#codex#defuddle#grok-bot#hermes

repo อื่นในหมวดเดียวกันMore in this category

ไปที่เพจ FacebookOpen Facebook page">