Obsidian + Claude Code Thực Chiến: 7 Skills, Workflows & Bases (2026)

Nếu bạn đã đọc bài hướng dẫn cài đặt và vault đã chạy được, bài này là bước tiếp theo. Mình sẽ không giải thích lại khái niệm cơ bản. Thay vào đó, mình đi thẳng vào các công cụ cụ thể và cách dùng chúng trong công việc thực tế.

Obsidian claude code kết hợp tốt nhất khi bạn có đúng skills và workflow. Mình mất gần hai tháng thử nghiệm để tìm ra cái gì thực sự hữu ích, cái gì chỉ là hype. Bài này tổng hợp lại những gì mình giữ lại sau quá trình đó.

7 Skills & Plugins Hay Nhất Cho Obsidian + Claude Code Là Gì?

Chỉ cd vào vault và gõ claude thì được, nhưng chưa đủ. Skills mới cho Claude hiểu cú pháp riêng của Obsidian như wikilinks, callouts, Bases format. Repo kepano/obsidian-skills với 22.1K GitHub stars là điểm bắt đầu tốt nhất hiện tại. Dưới đây là 7 lựa chọn theo nhu cầu cụ thể.

1. kepano/obsidian-skills (Official, 22.1K Stars)

Đây là bộ Claude Code Skills chính thức do Steph Ango, CEO của Obsidian, tạo ra. Với 22.1K stars trên GitHub (kepano/obsidian-skills), đây là repo được cộng đồng tin dùng nhất. Bộ này gồm 5 skills riêng biệt:

• obsidian-markdown: Dạy Claude hiểu wikilinks [[]], callouts > [!NOTE], frontmatter properties.
• obsidian-bases: Claude hiểu cú pháp Bases queries, tạo được .base files đúng format.
• json-canvas: Đọc và viết canvas files (.canvas).
• obsidian-cli: Điều khiển ứng dụng Obsidian qua URI scheme.
• defuddle: Xử lý web content, extract clean markdown từ HTML.

npx skills add kepano/obsidian-skills

Sau khi cài, Claude sẽ tự động dùng đúng cú pháp khi tạo ghi chú mới. Không cần nhắc nhở thêm. Đây là skill mình cài đầu tiên cho mọi vault mới.

2. Claude-obsidian (Karpathy Wiki Vault)

Repo claude-obsidian triển khai đầy đủ pattern wiki của Andrej Karpathy. Nếu bạn muốn Second Brain tự động cập nhật thì đây là lựa chọn mạnh nhất hiện tại.

Bộ commands chính: /wiki (khởi tạo cấu trúc), /ingest (nhập nguồn mới), /query (hỏi có citations), /lint (kiểm tra orphan pages, stale info), /autoresearch (tự động nghiên cứu entity). Hot cache system giúp các phiên sau load nhanh hơn. Có 6 wiki modes cho các loại nội dung khác nhau.

Workflow dùng hàng ngày: bỏ link hoặc file vào thư mục raw/, chạy /ingest, Claude tự tạo entity pages và cập nhật index. Mình dùng cái này để theo dõi nghiên cứu kỹ thuật.

3. second-brain (Multi-Agent)

Repo second-brain của Nicholas Spisak có setup wizard tự động và 4 skills được đóng gói sẵn. Điểm khác biệt: tương thích với nhiều AI agent (Claude Code, Cursor, Gemini CLI), không bị lock-in vào một tool.

npx skills add NicholasSpisak/second-brain

Setup wizard chạy lần đầu, hỏi bạn một số câu về vault structure rồi tự config. Phù hợp cho người muốn bắt đầu nhanh mà không cần tự viết CLAUDE.md từ đầu.

4. obsidian-mind (Persistent Memory Cho Engineers)

Repo obsidian-mind được thiết kế riêng cho kỹ sư phần mềm quản lý dự án nhiều tuần. Nó có 15 slash commands, 9 sub-agents chuyên biệt, và 5 lifecycle hooks.

Các commands hữu ích nhất trong thực tế:

• /standup: Tổng hợp context từ ngày hôm qua, tạo nhanh nội dung standup meeting.
• /dump: Nhập nhanh suy nghĩ rời rạc vào vault, Claude tự phân loại.
• /wrap-up: Kết thúc phiên làm việc, tóm tắt những gì đã làm và cần làm tiếp.
• /incident-capture: Ghi lại incident nhanh với timeline và root cause.
• /self-review: Review hiệu suất tuần qua dựa trên dữ liệu vault.

9 sub-agents hoạt động song song để xử lý các tác vụ khác nhau trong cùng một phiên. Đây là Obsidian Claude code setup nặng nhất trong danh sách, nhưng xứng đáng nếu bạn là engineer quản lý nhiều dự án.

5. Obsidian-CLI-skill (130+ Commands)

Obsidian-CLI-skill của Pablo Mano cung cấp hơn 130 CLI commands để điều khiển vault từ terminal. Yêu cầu Obsidian v1.12 trở lên và Local REST API plugin.

Commands được chia nhóm rõ: đọc/tạo/sửa notes, tìm kiếm toàn văn, quản lý tasks và tags, query metadata. Tương thích với Claude Code, Cursor, và GitHub Copilot. Dùng khi bạn cần Claude thực hiện các thao tác vault phức tạp mà không cần mở Obsidian UI.

6. Claudian (Agent Trong Vault, Không Cần Terminal)

Plugin Claudian nhúng Claude Code trực tiếp vào giao diện Obsidian. Không cần mở terminal một lần nào. Bạn dùng slash commands ngay trong vault, có inline editing, có plan mode để xem Claude định làm gì trước khi chạy.

Claudian dùng Anthropic SDK trực tiếp, không qua MCP. Nhược điểm: chỉ chạy desktop, cần Claude Code CLI cài sẵn. Phù hợp nhất cho người quen với Obsidian UI và không muốn chuyển qua lại giữa terminal và vault.

7. obsidian-claude-code-mcp (Real-time Sync)

Plugin obsidian-claude-code-mcp tạo kết nối hai chiều thực sự. Để hiểu rõ hơn về MCP là gì, đây là ứng dụng thực tế rõ nhất trong danh sách này.

Plugin cung cấp 7 tools: view, create, str_replace, insert, get_current_file, get_workspace_files, và obsidian_api. Tool get_current_file là tính năng độc đáo nhất: Claude biết chính xác bạn đang mở file nào trong Obsidian lúc đó. Kết nối qua WebSocket tự động ở port 22360. Cài qua Community Plugins, tìm “Claude Code” rồi enable.

4 Workflow Thực Tế Theo Vai Trò Nào Phù Hợp Với Bạn?

Obsidian Claude Code không có một cách dùng duy nhất cho tất cả. Workflow của developer khác hoàn toàn với content creator. Mình đã thử cả bốn vai trò dưới đây ở các mức độ khác nhau và tổng hợp lại những gì thực sự hoạt động, không phải lý thuyết.

Developer: Architecture Decision Records

Developer dùng Obsidian Claude Code hiệu quả nhất để lưu trữ và query các architecture decisions. Vấn đề cũ: bạn quyết định về database schema tháng trước, hai tuần sau quên lý do. Với vault, bạn hỏi thẳng: “Tại sao mình chọn PostgreSQL thay vì MongoDB cho project X?”

Setup cụ thể: tạo thư mục adr/ trong vault, mỗi decision là một file markdown có frontmatter: status, date, context, decision, consequences. File CLAUDE.md của dự án link đến vault để Claude biết tìm context ở đâu khi cần.

# Ví dụ query trong vault
/query Mình đã quyết định gì về database schema trong Q1 2026?
/query Lý do chọn Redis thay vì Memcached cho caching layer?
/query List tất cả breaking changes đã được ghi lại từ tháng 2

Claude trả lời có citations: “Theo ADR-007 ngày 15/2/2026, bạn chọn Redis vì…” Không cần tìm lại từ đầu. Thêm nữa: mỗi PR quan trọng, ingest PR description vào vault. Sau 6 tháng, bạn có lịch sử quyết định kỹ thuật hoàn chỉnh của team.

Product Manager: PRD Từ Meeting Notes

PM thường có vấn đề ngược lại với developer: quá nhiều thông tin rải rác, không đủ cấu trúc. Voice transcript từ meeting, Slack messages, feedback từ users, tất cả cần được tổng hợp thành PRD. Đây là nơi Obsidian Claude Code phát huy hiệu quả nhất.

Workflow: sau mỗi meeting, dump transcript vào raw/meetings/. Chạy /ingest để Claude tạo entity pages cho từng feature, từng stakeholder. Cuối tuần, chạy /weekly-review để tổng hợp 7 ngày. Rồi hỏi: “Tạo PRD cho feature X dựa trên feedback đã thu thập.”

Claude kéo thông tin từ nhiều nguồn, trích dẫn đúng transcript, và tạo PRD có structure chuẩn. Phần bạn phải tự làm: đọc lại và quyết định. Phần Claude làm thay: tổng hợp, phân loại, format.

Content Creator: Research đến Publish Pipeline

Mình dùng vai trò này nhiều nhất. Khi viết một bài về chủ đề kỹ thuật, mình ingest 10-15 bài tham khảo vào vault trước. Khi viết, hỏi: “Thống kê nào về X đáng tin cậy nhất trong research mình đã đọc?” Claude trả lời có source cụ thể.

Không cần nhớ từng chi tiết của từng bài. Không cần giữ 15 tab trình duyệt mở. Vault là bộ nhớ ngoài. Claude là interface để query bộ nhớ đó khi cần. Mình thấy tốc độ viết nhanh hơn đáng kể khi dùng workflow này so với tìm kiếm thủ công.

Researcher: Karpathy-Style Literature Wiki

Đây là use case gần nhất với pattern gốc của Karpathy. Bạn ingest papers và articles từng cái một vào raw/papers/. claude-obsidian tự build entity pages cho từng concept, cross-reference tự động. /lint định kỳ kiểm tra contradictions giữa các nguồn, stale information, orphan pages chưa được link.

Kết quả: sau vài tháng, bạn có một knowledge graph thực sự. Hỏi “Có bao nhiêu papers đồng ý về X?” và Claude so sánh được. Workflow này đặc biệt mạnh cho những ai theo dõi một lĩnh vực research dài hạn.

Obsidian Bases + Claude Code: Biến Vault Thành Database Được Không?

Obsidian Bases là core plugin (có sẵn từ Obsidian v1.9, không cần cài thêm), biến notes thành database views với 4 loại: Table, List, Cards, Map. Theo tài liệu chính thức của Obsidian, Bases cho phép filter, sort, và edit notes như một spreadsheet. Kết hợp với skill obsidian-bases trong kepano/obsidian-skills, Claude Code có thể tự tạo .base files hoàn chỉnh. Kết quả thực tế: task tracker, reading list, project dashboard hoạt động trực tiếp trong vault.

Bases hỗ trợ 4 view types: Table, List, Cards, và Map. Mỗi view đọc dữ liệu từ frontmatter của các notes bình thường. Không cần database riêng. Không cần sync. File markdown là nguồn dữ liệu duy nhất.

# Ví dụ: tạo reading list bằng Claude Code
Tạo một Obsidian Base file hiển thị tất cả notes trong thư mục
reading/ theo dạng Cards view, filter status = "unread",
sort by date added descending.

Claude (với obsidian-bases skill) tạo file reading-list.base đúng syntax ngay lập tức. Bạn không cần học Base Query Language. Chỉ cần mô tả bằng tiếng Việt những gì bạn muốn thấy.

Ba use case mình dùng nhiều nhất:

• Task tracker: Tất cả notes status: todo/doing/done hiện trong một Table view. Claude tự cập nhật status khi bạn báo đã xong.
• Reading list: Cards view với thumbnail, title, tags, progress. Ingest xong là xuất hiện tự động.
• Project dashboard: Map view nếu projects có địa điểm, Table view với timeline, budget, status.

Làm Sao Tạo 3 Custom Skills Cho Vault Của Chính Mình?

Skills mặc định phục vụ chung cho mọi người. Custom skills mới thực sự mạnh vì chúng hiểu đúng context của vault của bạn. Mart Kempenaar chia sẻ trên Medium ba custom skills thay đổi cách ông dùng obsidian claude code hàng ngày: /context, /today, và /spark.

Cách tạo: dùng lệnh /skill-creator trong Claude Code để được hướng dẫn, hoặc tạo file SKILL.md thủ công trong .claude/skills/. Mình giải thích từng cái:

Skill /context: Load Vault State Đầu Phiên

Skill này chạy đầu mỗi phiên làm việc, tổng hợp “bức tranh toàn cảnh” của vault. Nó đọc các file đang active, tasks chưa xong, và context từ phiên cuối. Claude có đủ thông tin để tiếp tục đúng chỗ bạn dừng lại hôm qua.

# .claude/skills/context/SKILL.md
---
name: context
description: Load vault state at session start
---

## Instructions
1. Read CLAUDE.md for current focus areas
2. List all tasks with status "doing" or "todo" from tasks/
3. Read the last 3 daily notes from daily/ folder
4. Summarize: what's active, what's blocked, what needs attention
5. Ask: "Hôm nay bạn muốn tập trung vào gì?"

Skill /today: Daily Planning

Skill /today kéo thông tin từ nhiều nguồn: calendar events (nếu bạn sync iCal vào vault), tasks do hôm nay, notes từ hôm qua chưa xử lý. Output là một daily note có structure, không phải trang trắng. Cấu trúc SKILL.md tương tự /context:

---
name: today
description: Tạo daily note từ calendar, tasks, và notes hôm qua
---

1. Đọc notes/ thư mục, lọc files modified trong 24h qua
2. Đọc tasks có due date = hôm nay (frontmatter: due)
3. Tạo file notes/daily/[YYYY-MM-DD].md với format:
   - Tóm tắt hôm qua (từ notes modified)
   - Tasks hôm nay (từ frontmatter due)
   - Focus blocks (3 priorities)

Skill /spark: Pattern Recognition

Skill /spark là cái mình thích nhất. Nó scan vault, tìm những ghi chú chưa được liên kết với nhau nhưng có chủ đề liên quan, rồi đề xuất connections. Bạn có thể bỏ qua 90% đề xuất, nhưng 10% còn lại thường là những insight thú vị bạn chưa nhận ra.

Workflow của mình hàng ngày trông như thế nào?

Mình không dùng tất cả 7 skills cùng lúc. Sau hai tháng thử nghiệm, ông bố IT giữ lại một workflow tối giản: kepano/obsidian-skills làm nền, obsidian-mind cho engineering context, và ba custom skills /context, /today, /spark. Đủ dùng, không quá tải.

Buổi Sáng (5-10 phút)

Mở terminal, cd vào vault, chạy:

cd ~/Documents/OngBoIT-Vault
claude
/context
/today

/context cho mình biết hôm qua đang làm gì, tasks nào còn dang dở. /today tạo daily note với những gì cần làm hôm nay. Cả hai mất khoảng 30 giây. Không cần nhớ lại từ đầu sau một đêm ngủ.

Trong Ngày (Real-time)

Khi học được điều gì thú vị, đọc bài nào hay: /ingest [link hoặc paste nội dung]. Claude tạo summary và entity pages tự động. Khi có ý tưởng đột xuất: /idea [mô tả nhanh]. Khi xong một task: /log [những gì đã làm]. Ba lệnh này không mất quá 2 phút mỗi lần.

Cuối Tuần (Tổng Kết)

Mỗi cuối tuần mình chạy hai lệnh: /weekly-review và /lint. /weekly-review tổng hợp toàn bộ tuần, tạo report ngắn về những gì đã làm được. /lint dọn dẹp vault: tìm orphan pages, stale links, notes chưa được categorize.

Hugo Sequier ghi nhận weekly review giảm từ 30 phút xuống 5 phút sau khi áp dụng workflow tương tự. Mình đồng ý với con số đó. Phần mất thời gian trước đây là tìm lại thông tin rải rác. Bây giờ Claude làm việc đó.

Câu Hỏi Thường Gặp Về Obsidian Claude Code

Skills khác gì với Obsidian plugins?

Skills là files markdown trong .claude/skills/ chạy phía Claude Code, không phải phía Obsidian. Obsidian plugins chạy trong ứng dụng Obsidian, thêm tính năng vào UI. Trong hệ sinh thái Obsidian Claude Code, skills dạy Claude cách làm việc với Vault. Plugins thay đổi giao diện Obsidian. Hai thứ độc lập nhau, không thay thế nhau. Xem thêm về Claude Code Skills để hiểu rõ hơn.

Có cần cài tất cả 7 skills không?

Không. Mình khuyên bắt đầu với duy nhất kepano/obsidian-skills. Dùng một tuần, quen với workflow cơ bản. Sau đó thêm obsidian-mind hoặc claude-obsidian tùy nhu cầu cụ thể. Cài nhiều quá ngay từ đầu sẽ khó biết cái nào đang làm gì. Hầu hết người dùng Obsidian Claude Code chỉ cần 2-3 skills là đủ.

Vault bao nhiêu notes thì cần tools bổ sung?

Với vault dưới 200 notes, cd đơn giản và kepano/obsidian-skills là đủ. Karpathy khuyến nghị với hơn 500 notes, nên dùng qmd (query markdown) để tìm kiếm nhanh hơn. Với hơn 1.000 notes, cân nhắc cài obsidian-claude-code-mcp để có real-time context. Context window 1M tokens của Claude Sonnet 4.6 xử lý được vault lớn, nhưng tốc độ load sẽ chậm hơn.

Dùng được trên mobile không?

Obsidian mobile app đọc và ghi notes bình thường. Nhưng Claude Code CLI không chạy trên mobile. Plugin Claudian cũng chỉ hỗ trợ desktop. Workflow thực tế: dùng mobile để xem vault và thêm notes nhanh, dùng desktop với Claude Code để xử lý và query. Hai nền tảng bổ sung nhau, không thay thế. Workflow Obsidian Claude code hiệu quả nhất trên desktop.

Nên tạo custom skill gì đầu tiên?

Tạo /context trước. Nó đơn giản nhất và có lợi ích ngay lập tức: mỗi sáng bạn sẽ không mất 5 phút để nhớ lại hôm qua đang làm gì. Sau khi quen với cấu trúc SKILL.md, thêm /today. Chỉ tạo /spark sau khi vault đã có ít nhất 100 notes, vì ít hơn thì pattern recognition không có đủ dữ liệu để hoạt động. Xem hướng dẫn chi tiết để tạo skill từ đầu.

Bắt Đầu Từ Đâu Sau Bài Này

Obsidian Claude Code là một hành trình dài hạn, không phải setup một lần xong. Mình vẫn đang điều chỉnh workflow sau hai tháng. Bắt đầu với cái đơn giản nhất: cài kepano/obsidian-skills, thử một workflow theo role của bạn, dùng một tuần rồi mới thêm. Đó là cách hiệu quả nhất mình tìm ra.