Nếu anh dùng Obsidian làm “bộ não thứ hai” và bắt đầu giao việc cho AI agent, obsidian-skills là một kho đáng xem. Đây là bộ hướng dẫn mở để agent hiểu đúng cách làm việc với vault Obsidian: Markdown có wikilink/callout, Bases, JSON Canvas, Obsidian CLI và trích nội dung web sạch bằng Defuddle.
Repo kepano/obsidian-skills do tài khoản kepano công bố. Steph Ango xác nhận trên trang cá nhân rằng anh là CEO hiện tại của Obsidian. Tại thời điểm kiểm tra ngày 19/07/2026, repo có khoảng 42.6K stars; đây là số liệu biến động nên nên xem trực tiếp tại GitHub để có con số mới nhất.
obsidian-skills là gì?
“Skill” ở đây không phải plugin Obsidian theo nghĩa quen thuộc. Nó là một thư mục chứa file SKILL.md, mô tả khi nào agent dùng skill và hướng dẫn thao tác cụ thể. Chuẩn Agent Skills mô tả skill như một định dạng mở, nhẹ, có thể kèm tài liệu tham khảo, script và asset để bổ sung năng lực/chuyên môn cho AI agent.
Lợi ích thực tế là agent không chỉ “biết Markdown chung chung”, mà có quy tắc rõ ràng để tạo note hợp lệ với hệ sinh thái Obsidian. Điều này giảm nguy cơ agent tạo link sai, phá frontmatter/properties, viết Canvas sai JSON hoặc dùng CLI theo cách không đúng.
5 skill trong kho
1. obsidian-markdown
Skill này hướng dẫn tạo và sửa Obsidian Flavored Markdown: properties/frontmatter, wikilink, embed, callout, tags, comment, Mermaid và các cú pháp mở rộng khác. Ví dụ, agent được nhắc dùng [[Tên note]] cho liên kết nội bộ (Obsidian theo dõi rename) và Markdown link chuẩn cho URL bên ngoài.
2. obsidian-bases
Dành cho Bases — core plugin biến các note và properties thành các view gần giống database. Tài liệu Obsidian nêu Bases có thể xem, sửa, sắp xếp và lọc file/properties; có table, list, cards và map. Skill giúp agent làm việc với view, filter, công thức và cú pháp Base thay vì đoán định dạng.
3. json-canvas
Dùng để tạo hoặc sửa file JSON Canvas: các node, edge, group và bố cục sơ đồ. Nó hữu ích khi giao agent dựng mind map, planning board hoặc bản đồ ý tưởng trong Obsidian Canvas.
4. obsidian-cli
Skill dạy agent dùng Obsidian CLI để đọc, tạo, tìm kiếm và quản lý note, task, properties trong vault; đồng thời có lệnh hỗ trợ phát triển plugin/theme như reload plugin, xem lỗi, chụp screenshot và inspect DOM. Theo tài liệu Obsidian, CLI cần Obsidian 1.12.7+ và app cần chạy (hoặc được lệnh đầu tiên khởi chạy).
5. defuddle
Defuddle CLI trích phần nội dung đọc được từ trang web thành Markdown và bỏ bớt navigation, quảng cáo, phần rác. Với agent phải đọc bài viết/tài liệu online, đây là cách giảm lượng text không liên quan, từ đó tiết kiệm context/token. Đây là skill về đọc web sạch, không phải công cụ chỉnh note trực tiếp.
Điểm hay: không khóa vào một AI agent
README của repo ghi các skill tuân theo Agent Skills specification, nên có thể dùng với agent tương thích, bao gồm Claude Code, Codex và OpenCode. Không phải mọi agent đều có cùng cách cài hay mức hỗ trợ giống nhau; hãy xem tài liệu của agent đang dùng trước khi cài. Giá trị của chuẩn chung là cùng một bộ tri thức có thể tái sử dụng, thay vì viết prompt hướng dẫn Obsidian lại cho từng công cụ.
Cài đặt theo README chính thức
Repo đưa ra vài cách cài. Với client có hỗ trợ marketplace plugin, README minh họa:
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skillsHoặc dùng công cụ npx skills:
npx skills add https://github.com/kepano/obsidian-skillsNếu agent không có trình cài skill tự động, README cũng có hướng dẫn manual. Quan trọng: chỉ cài từ repo chính thức, đọc nội dung SKILL.md trước khi để agent có quyền ghi/sửa vault, và thử trong vault sandbox trước.
Workflow gợi ý cho người dùng Obsidian
- Bắt đầu bằng obsidian-markdown để agent ghi note mới theo template, properties và wikilink hiện có.
- Dùng Defuddle khi cần tóm tắt một URL về Markdown sạch, sau đó yêu cầu agent tạo note kèm nguồn.
- Khi vault đã có quy ước properties, dùng obsidian-bases để lập view theo project, status hoặc tag.
- Dùng json-canvas cho brainstorm, roadmap hoặc map liên kết giữa các ý.
- Chỉ bật obsidian-cli khi đã hiểu phạm vi quyền của agent; ưu tiên lệnh đọc/tìm kiếm trước, rồi mới cho phép tạo/sửa hàng loạt.
Ưu điểm và lưu ý
| Ưu điểm | Lưu ý thực tế |
|---|---|
| MIT, miễn phí và có thể kiểm tra nội dung hướng dẫn | Skill không thay thế backup; agent vẫn có thể sửa hàng loạt nếu được cấp quyền |
| Đúng ngữ cảnh format đặc thù của Obsidian | Vault mỗi người có template/naming/tag riêng; nên bổ sung quy ước riêng của anh |
| Portable giữa nhiều agent hỗ trợ Agent Skills | Cách cài và tool permission phụ thuộc từng agent/client |
| Có phạm vi từ note đến Base, Canvas, CLI và đọc web | CLI yêu cầu phiên bản Obsidian phù hợp và môi trường app đang chạy |
Có nên dùng?
Có, đặc biệt nếu anh dùng Obsidian lâu dài và muốn AI làm việc “đúng chuẩn vault” hơn. Đây không phải phép màu biến agent thành người hiểu toàn bộ hệ thống ghi chú cá nhân của anh. Nhưng nó là lớp nền rất tốt: chuẩn hóa cú pháp, workflow và công cụ. Sau khi cài, anh vẫn nên bổ sung một skill hoặc file hướng dẫn riêng cho naming, cấu trúc folder, tags, template và quy tắc không được phép xóa/sửa của vault.
Nguồn kiểm chứng
Thông tin kiểm tra ngày 19/07/2026 từ repo obsidian-skills, trang giới thiệu Steph Ango, Agent Skills specification, tài liệu Bases và tài liệu Obsidian CLI.
