Skilldocs
Figma phiên bản Markdown, chuyên để viết tài liệu kỹ năng cho AI agent đọc
Giới thiệu một câu về Skilldocs là "Figma for markdown" - một trình soạn thảo Markdown cộng tác thời gian thực, chuyên để viết và duy trì các tài liệu kỹ năng (skills) mà AI agent sẽ đọc.
Tính năng nổi bật và tình huống áp dụng
Vì sao tài liệu kỹ năng cần công cụ chuyên dụng? Vì sau năm 2026, "đặc tả" mà đội ngũ đưa cho agent ngày càng giống mã nguồn: quy ước đặt tên, các bước triển khai, tiêu chuẩn rà soát, tất cả viết trong Markdown để agent làm theo. Nhưng loại tài liệu này thường rải rác giữa repo, Notion, Google Docs, sửa rồi chẳng ai biết, agent làm theo bản cũ, người thì vẫn đang đoán sai ở đâu.
Cách làm của Skilldocs là làm cho trải nghiệm cộng tác tới nơi tới chốn: nhiều người sửa thời gian thực, thấy được con trỏ của nhau, có thể đi theo góc nhìn của một người nào đó, bình luận nội dòng, Markdown render vừa gõ vừa hiện (WYSIWYG), sửa đa con trỏ, chế độ tối. Then chốt hơn là nó nhập xuất được GitHub và file cục bộ, và có sẵn MCP server - agent đọc thẳng được tài liệu kỹ năng bạn đang sửa, người và agent xem cùng một bản.
Cách dùng thực tế là: chia sẻ diff và phản hồi trực tiếp cho coding agent. Bạn sửa xong đặc tả, agent lập tức hành động theo bản mới, không cần commit trước rồi pull rồi khởi động lại.
Nó do Rajiv Ayyangar ra mắt năm 2026, hiện miễn phí. Ngăn xếp kỹ thuật dùng Cloudflare, Vercel và Claude Code - ở mức độ nào đó cũng coi là tự chứng minh cho loại công cụ này.
Tính năng chính
- Cộng tác nhiều người thời gian thực, con trỏ động và đi theo góc nhìn
- Soạn thảo Markdown vừa gõ vừa hiện (WYSIWYG)
- Bình luận nội dòng và quản lý phiên bản
- Nhập xuất GitHub và file cục bộ
- MCP server tích hợp sẵn, agent đọc thẳng được
- Sửa đa con trỏ và chế độ tối
Ưu điểm
- Biến tài liệu kỹ năng từ rải rác khắp nơi thành một nguồn cộng tác duy nhất
- Tích hợp MCP để agent đọc bản mới nhất tức thời, không phải commit trước
- Hiện miễn phí, chi phí triển khai bằng không
Nhược điểm
- Tính năng tập trung vào cộng tác Markdown, không dùng như kho tri thức thông thường được
- Sản phẩm mới năm 2026, chiến lược định giá dài hạn chưa rõ ràng
- Nên quy hoạch trước việc xuất và di chuyển dữ liệu sau giai đoạn miễn phí
Trường hợp sử dụng
- Đội ngũ cùng duy trì tài liệu kỹ năng và quy phạm của AI agent
- Quản lý tập trung quy tắc hành vi của coding agent
- Cộng tác thời gian thực và thảo luận nội dòng cho đặc tả kỹ thuật
- Cho agent đọc bản đặc tả mới nhất qua MCP
Ghi chú biên tập
Tôi cho rằng một trong những kỹ năng quan trọng nhất năm 2026 là "viết tri thức công ty thành định dạng mà agent đọc hiểu được". Việc này trước đây gọi là viết tài liệu, giờ đồng thời là viết chương trình. Skilldocs bắt được bước chuyển này, bản thân công cụ cũng đủ nhẹ, đáng để đội thử một vòng.
Câu hỏi thường gặp
Khác gì với việc để Markdown thẳng trên GitHub?
GitHub phù hợp kiểm soát phiên bản nhưng không phù hợp soạn chung thời gian thực, sửa một chữ mà phải mở PR thì rất mệt. Skilldocs bù vào trải nghiệm cộng tác ngay lúc chỉnh sửa, đồng thời giữ khả năng nhập xuất GitHub, hai bên có thể cùng tồn tại chứ không phải chọn một.
"Tài liệu kỹ năng" là gì?
Chỉ những quy phạm thao tác bạn viết cho AI agent đọc, ví dụ quy ước đặt tên của dự án, các bước triển khai, tiêu chuẩn rà soát mã. Agent đọc xong làm theo, tức là dùng tài liệu chứ không phải prompt để quản lý hành vi của agent.
Công cụ AI liên quan
Claude
Trợ lý AI do Anthropic phát triển, chuyên gia xử lý văn bản dài và đối thoại an toàn.
ChatGPT
Trợ lý AI trò chuyện do OpenAI phát triển.
bitdrift
Khả năng quan sát thời gian thực cho ứng dụng di động, log lưu trên thiết bị trước, cần mới kéo về
Supermemory
Lớp trí nhớ cho AI agent, lưu sở thích và tri thức người dùng thành một đồ thị tra được
Aloud
Nói vào màn hình là biến phản hồi thành nhiệm vụ mà coding agent hiểu được
MeetStream AI
API thống nhất cho bot họp, một bộ giao diện thông suốt ghi âm, phân tích và ghi ngược vào CRM