Xây dựng Skills cho Claude — Phần 4: Phân phối và Chia sẻ

Dịch và biên soạn từ "The Complete Guide to Building Skills for Claude" của Anthropic.

Bạn đã xây dựng và test skill thành công ở Phần 3. Giờ là lúc đưa skill đến tay người dùng. Bài viết này hướng dẫn mô hình phân phối, cách sử dụng qua API, và chiến lược định vị skill của bạn.

Mô hình phân phối hiện tại

Cho người dùng cá nhân

Quy trình cài đặt skill hiện tại gồm 4 bước:

1. Tải thư mục skill về
2. Nén thành file zip (nếu cần)
3. Upload lên Claude.ai qua Settings > Capabilities > Skills
4. Hoặc đặt vào thư mục skills của Claude Code

Cho tổ chức (Organization-level)

Anthropic đã ra mắt tính năng triển khai skill cấp tổ chức từ tháng 12/2025:

• Admin có thể deploy skill cho toàn bộ workspace
• Cập nhật tự động cho tất cả thành viên
• Quản lý tập trung

Đây là tính năng đặc biệt hữu ích cho các công ty Việt Nam muốn chuẩn hoá cách team sử dụng Claude. Ví dụ: một công ty phần mềm có thể triển khai skill "code-review" và "sprint-planning" cho toàn bộ đội ngũ engineering, đảm bảo mọi người tuân theo cùng một quy trình.

Open Standard: Tiêu chuẩn mở

Anthropic đã công bố Agent Skills như một tiêu chuẩn mở. Giống như MCP, họ tin rằng skills nên portable giữa các công cụ và nền tảng. Cùng một skill có thể hoạt động dù bạn đang dùng Claude hay các nền tảng AI khác.

Tuy nhiên, một số skill được thiết kế để tận dụng tối đa khả năng của một nền tảng cụ thể. Tác giả có thể ghi chú điều này trong trường compatibility của skill.

Sử dụng Skills qua API

Với các use case lập trình -- xây dựng ứng dụng, agent, hoặc quy trình tự động -- API cung cấp quyền kiểm soát trực tiếp về quản lý và thực thi skill.

Khả năng chính

• Endpoint /v1/skills để liệt kê và quản lý skills
• Thêm skills vào Messages API requests qua tham số container.skills
• Quản lý phiên bản qua Claude Console
• Hoạt động với Claude Agent SDK để xây dựng agent tuỳ chỉnh

Khi nào dùng API, khi nào dùng Claude.ai?

Lưu ý quan trọng: Skills trong API yêu cầu Code Execution Tool beta, cung cấp môi trường bảo mật mà skills cần để chạy.

Tài liệu kỹ thuật

• Skills API Quickstart
• Create Custom Skills
• Skills in the Agent SDK

Hosting trên GitHub: Cách tiếp cận được khuyến nghị

Anthropic khuyến nghị bắt đầu bằng việc host skill trên GitHub:

Bước 1: Tạo repository GitHub

• Repo public cho skill mã nguồn mở
• README rõ ràng với hướng dẫn cài đặt (README ở cấp repo, KHÔNG đặt trong thư mục skill)
• Ví dụ sử dụng kèm screenshots

Bước 2: Tài liệu trong MCP Repo

• Liên kết đến skills từ tài liệu MCP
• Giải thích giá trị khi dùng cả hai cùng nhau
• Cung cấp quick-start guide

Bước 3: Tạo Installation Guide

## Cai dat skill [Ten Dich Vu]

1. Tai skill:
   - Clone repo: git clone https://github.com/yourcompany/skills
   - Hoac tai ZIP tu Releases

2. Cai dat trong Claude:
   - Mo Claude.ai > Settings > Skills
   - Nhan "Upload skill"
   - Chon thu muc skill (da nen zip)

3. Kich hoat skill:
   - Bat skill [Ten Dich Vu]
   - Dam bao MCP server da ket noi

4. Test:
   - Hoi Claude: "Thiet lap du an moi trong [Ten Dich Vu]"

Định vị Skill: Outcomes thay vì Features

Cách bạn mô tả skill quyết định liệu người dùng có hiểu giá trị và thực sự dùng thử hay không. Khi viết về skill trong README, tài liệu, hay marketing, hãy tuân theo các nguyên tắc sau:

Tập trung vào kết quả, không phải tính năng

# Tot
"Skill ProjectHub giup team thiet lap workspace du an hoan chinh
trong vai giay — bao gom pages, databases, va templates — thay
vi mat 30 phut setup thu cong."

# Te
"Skill ProjectHub la thu muc chua YAML frontmatter va huong dan
Markdown goi cac cong cu MCP server."

Nhấn mạnh câu chuyện MCP + Skills

"MCP server cua chung toi cho phep Claude truy cap du an Linear.
Skills cua chung toi day Claude quy trinh lap ke hoach sprint
cua team ban. Ket hop lai, chung tao nen quan ly du an
bang AI."

Ví dụ thực tế: Phân phối skill cho team Việt Nam

Giả sử bạn xây dựng skill "shopify-theme-setup" cho agency của mình:

Bước 1: Phát triển và test nội bộ

Cài đặt thủ công cho 2-3 developer senior, thu thập feedback trong 1-2 tuần.

Bước 2: Triển khai cấp team

Nếu tổ chức dùng Claude Teams/Enterprise, deploy qua organization-level skills. Nếu không, tạo repo GitHub internal và hướng dẫn cài đặt.

Bước 3: Chia sẻ cộng đồng

Nếu skill có giá trị chung, public repo trên GitHub, viết bài blog giới thiệu, chia sẻ trên các cộng đồng developer Việt Nam.

Bước 4: Duy trì và cập nhật

Theo dõi issue trên GitHub, cập nhật version trong metadata, thông báo thay đổi cho người dùng.

Chiến lược phân phối theo quy mô

Lưu ý bảo mật khi phân phối

• Không đưa API key hay credentials vào skill
• Sử dụng biến môi trường cho thông tin nhạy cảm
• Review code trong scripts/ trước khi chia sẻ
• Ghi rõ quyền truy cập cần thiết trong README
• Cân nhắc dùng license phù hợp (MIT cho mã nguồn mở, proprietary cho nội bộ)

Tổng kết Phần 4

Bạn đã nắm được:

• Mô hình phân phối: cá nhân, tổ chức, và cộng đồng
• Agent Skills là tiêu chuẩn mở, portable giữa các nền tảng
• Cách sử dụng Skills qua API cho production deployment
• Hosting trên GitHub với installation guide
• Định vị skill theo outcomes thay vì features
• Câu chuyện MCP + Skills

Trong Phần 5, chúng ta sẽ đi vào phần thực chiến nhất: 5 patterns thiết kế skill phổ biến và cách xử lý các lỗi thường gặp.