Phân phối và chia sẻ Skill
4 kênh triển khai
Cách cài đặt và chia sẻ skill Claude qua bốn kênh, mỗi kênh có phạm vi chia sẻ và cách cài hoàn toàn khác nhau.
🎯 Mục tiêu bài học
- Chọn đúng kênh phân phối theo phạm vi người dùng bạn nhắm tới.
- Nắm giới hạn quan trọng: skill KHÔNG tự đồng bộ giữa các nền tảng.
- Cài skill vào Claude Code cho cá nhân, cho dự án và cho monorepo.
- Định vị skill theo giá trị mang lại thay vì theo đặc tả kỹ thuật khi giới thiệu cho đồng nghiệp.
Mỗi kênh một phạm vi chia sẻ
Claude.ai — cá nhân
Nén thư mục skill thành file .zip rồi upload qua Settings > Features. Cần gói Pro, Max, Team hoặc Enterprise và bật code execution. Phạm vi: chỉ cá nhân bạn — mỗi thành viên phải tự upload.
Claude Code — cá nhân hoặc dự án
Đặt thư mục vào ~/.claude/skills/ để dùng cho mọi dự án, hoặc .claude/skills/ trong repo để dùng riêng dự án đó. Không cần upload — Claude Code tự phát hiện file.
Claude API — toàn workspace
Upload qua các endpoint /v1/skills với beta header skills-2025-10-02. Phạm vi: toàn bộ thành viên workspace đều truy cập được. Đây là kênh duy nhất chia sẻ được cho cả nhóm.
GitHub — chuẩn mở
Public mã nguồn skill theo chuẩn Agent Skills mở. Cộng đồng tải về, tái sử dụng và đóng góp cải tiến. Anthropic cũng công bố skill mã nguồn mở theo cách này.
⚠️ Giới hạn quan trọng nhất: Skill KHÔNG tự đồng bộ giữa các nền tảng
Skill bạn upload lên Claude.ai không tự xuất hiện trên API. Skill upload qua API không tự xuất hiện trên Claude.ai. Skill trong Claude Code nằm trên ổ đĩa, tách biệt với cả hai. Phải quản lý và upload riêng cho từng nền tảng bạn muốn dùng. Hãy giữ một bản gốc duy nhất trong Git và coi các nơi khác là bản triển khai.
Chọn kênh nào cho tình huống của bạn
| Nền tảng | Phạm vi chia sẻ | Quản trị tập trung | Cách cài |
|---|---|---|---|
| Claude.ai | Cá nhân từng người dùng | ❌ Không hỗ trợ | Upload file zip qua Settings |
| Claude Code | Cá nhân hoặc theo dự án (commit vào repo) | ⚠️ Qua Git và Plugin | Đặt thư mục vào đúng đường dẫn |
| Claude API | Toàn workspace | ✅ Có, qua API | Gọi endpoint /v1/skills |
| GitHub | Công khai cho cộng đồng | — | Người dùng tự clone hoặc tải về |
📝 Đính chính: Claude.ai KHÔNG có quản trị tập trung cho custom skill
Một số tài liệu nói admin doanh nghiệp có thể "deploy skill workspace-wide trên Claude.ai và tự động đồng bộ cho toàn bộ nhân viên". Tài liệu chính thức nêu rõ: "claude.ai does not support centralized admin management or org-wide distribution of custom Skills". Custom skill trên Claude.ai là của riêng từng người dùng. Muốn chia sẻ cho cả nhóm, hãy dùng Claude API (phạm vi workspace) hoặc commit vào repo cho Claude Code.
Ba vị trí đặt skill trong Claude Code
# 1. Cá nhân — dùng cho mọi dự án trên máy bạn
mkdir -p ~/.claude/skills/bao-cao-tuan-chuan
# rồi tạo file ~/.claude/skills/bao-cao-tuan-chuan/SKILL.md
# 2. Theo dự án — commit vào repo, cả team cùng dùng
mkdir -p .claude/skills/bao-cao-tuan-chuan
git add .claude/skills && git commit -m "Add skill bao-cao-tuan-chuan"
# 3. Theo package trong monorepo — chỉ áp dụng khi làm việc ở thư mục đó
mkdir -p apps/web/.claude/skills/deploy
# Gọi trực tiếp bằng tên thư mục:
# /bao-cao-tuan-chuan
# Hoặc để Claude tự kích hoạt khi yêu cầu khớp description.Định vị skill theo giá trị, không theo kỹ thuật
| ⛔ Cách viết kỹ thuật (sai lầm) | ✅ Cách viết giá trị (chuẩn) | |
|---|---|---|
| Câu giới thiệu | "Skill này chứa YAML frontmatter và hướng dẫn markdown để gọi API xử lý văn bản." | "Biến 2 giờ soạn báo cáo thành 5 phút. Tự tạo báo cáo BLUF chuẩn form, sẵn sàng gửi sếp ngay." |
| Người nghe hiểu gì | Không rõ nó giúp được gì cho công việc của mình | Hiểu ngay tiết kiệm bao nhiêu thời gian và nhận được sản phẩm gì |
| Tỷ lệ được dùng lại | Thấp — nghe như việc của dev | Cao — nghe như việc của chính mình |
FAQ — 3 câu hỏi thường gặp về cách cài đặt và chia sẻ skill claude
Bốn kênh phân phối skill là gì?
Claude.ai — upload zip qua Settings → Features, phạm vi cá nhân. Claude Code — đặt thư mục vào ~/.claude/skills/ hoặc .claude/skills/. Claude API — endpoint /v1/skills, phạm vi toàn workspace. GitHub — chuẩn mở cho cộng đồng.
Skill upload lên Claude.ai có tự dùng được trên Claude Code không?
Không. Skill KHÔNG đồng bộ giữa các nền tảng — mỗi nơi phải cài riêng. Hãy giữ một bản gốc duy nhất trong Git và coi các nơi khác là bản triển khai.
Muốn chia sẻ skill cho cả nhóm thì dùng kênh nào?
Dùng Claude API (phạm vi workspace, mọi thành viên truy cập được) hoặc commit vào repo cho Claude Code. Claude.ai không hỗ trợ quản trị tập trung cho custom skill — mỗi người phải tự upload.
Nguồn: Bài viết biên soạn dựa trên tài liệu Xây dựng bộ Skills cho Claude (Anthropic Academy, bản tiếng Việt do Nguyen Ngoc Tuan trình bày), đã viết lại và đối chiếu với tài liệu Agent Skills chính thức của Anthropic (platform.claude.com và code.claude.com), cập nhật 15/08/2026. Mọi số liệu kỹ thuật lấy theo tài liệu chính thức.