TL;DR

Claude Skills là cách đóng gói workflow để Claude làm lại cho nhất quán. Guide chính thức của Anthropic không mô tả Skills như “prompt dài hơn”, mà như một thư mục chứa hướng dẫn, file phụ trợ và logic sử dụng lại được. Nếu bạn có vài quy trình quen tay như tạo tài liệu, làm research, review output, hoặc ghép nhiều bước qua MCP, đây là lớp rất hợp để chuẩn hóa.

Điểm đáng giá nhất là progressive disclosure: Claude chỉ tải metadata trước, rồi mới đọc phần thân và file liên quan khi cần. Nhờ vậy bạn có thể mang theo nhiều tri thức hơn mà không làm nổ context. Anthropic nói rằng nếu đã biết rõ 2-3 workflow muốn tự động hóa, bạn có thể dựng skill đầu tiên trong khoảng 15-30 phút.

Skill thực ra là gì

Trong Claude Code docs, một skill là một folder có SKILL.md bắt buộc, còn scripts/, references/ và assets/ là tùy chọn. Cách này nhìn tối giản, nhưng đó là chủ đích: bạn tách phần hướng dẫn, phần code và phần tài liệu phụ trợ ra khỏi nhau thay vì nhồi tất cả vào một prompt duy nhất.

Anthropic mô tả skill như một bộ instructions được đóng gói thành folder, để Claude học một lần rồi dùng lại ở nhiều cuộc trò chuyện. via Claude

Vì sao không chỉ dùng prompt

Prompt tốt vẫn hữu ích, nhưng prompt rời rạc sống trong từng cuộc chat. Bạn copy, dán, chỉnh sửa, rồi làm lại ở phiên sau. Khi quy trình chỉ nằm trong đầu một người hoặc trong lịch sử chat, team rất dễ lệch cách làm.

Skills giải quyết đúng điểm đó. Claude Code docs nói rõ rằng metadata của skill được nạp trước để Claude biết lúc nào nên gọi nó, còn phần thân chỉ load khi skill thật sự liên quan. Nói ngắn gọn, skills biến một procedure thành một tài sản có thể discover, load và tái sử dụng. via Claude Code Docs

Cấu trúc nên đi như thế nào

Guide của Anthropic khuyên bắt đầu bằng use case, không phải bằng file. Họ muốn bạn chọn trước 2-3 workflow thật sự lặp lại, rồi mới viết skill cho đúng việc. Một skill tốt thường trả lời được 4 câu: khi nào dùng, cần input gì, các bước ra sao, và thế nào là xong.

  • Document & asset creation: tạo tài liệu, deck, giao diện, code hoặc report theo style guide.
  • Workflow automation: điều phối nhiều bước, có validation gate, template và vòng lặp cải tiến.
  • MCP enhancement: nâng trải nghiệm khi Claude đã có connector nhưng vẫn cần workflow rõ ràng.

Nếu không mô tả được đầu ra cụ thể, skill đó thường đang quá rộng. Nếu phải giải thích quá nhiều lần trước khi Claude làm đúng, skill đó thường chưa đủ sắc.

Thứ bạn đang có Nên dùng khi nào
Prompt Chỉ cần một lần, không cần tái dùng
Skill Quy trình lặp lại, cần chuẩn hóa
MCP Cần kết nối dữ liệu hoặc tool bên ngoài
Subagent Cần agent độc lập với context và tool riêng

MCP và Skill đi cùng nhau như thế nào

Anthropic dùng một so sánh rất dễ nhớ: MCP là nhà bếp, còn skill là công thức. MCP cho Claude tool, dữ liệu và khả năng kết nối. Skill dạy Claude phải dùng những thứ đó theo cách nào để ra kết quả tốt hơn.

MCP cung cấp tool và dữ liệu, còn Skill điều phối workflow và validation
MCP mở đường tới dữ liệu và tool; Skill định hình cách dùng chúng thành workflow có kiểm tra.

Nếu chỉ có MCP mà không có skill, người dùng có thể connect được tool nhưng vẫn không biết bắt đầu từ đâu. Nếu thêm skill, workflow tốt có thể xuất hiện đúng lúc, kèm theo best practice và validation logic. via Anthropic

Một skill tốt trông ra sao

Anthropic chia use case của Skills thành ba nhóm quen thuộc: tạo tài liệu và asset nhất quán, tự động hóa workflow nhiều bước, và nâng MCP bằng domain knowledge. Từ đó, một skill tốt thường có metadata đủ sắc, body đủ ngắn, và file phụ trợ chỉ xuất hiện khi thật sự cần.

Ba lớp progressive disclosure của Claude Skill
Progressive disclosure: Claude đọc metadata trước, rồi chỉ tải hướng dẫn và file phụ trợ khi tác vụ cần đến.
  • Metadata phải đủ cụ thể để Claude nhận ra lúc nào nên trigger.
  • Input và output phải rõ để tránh kiểu “làm cho hay hơn”.
  • Checkpoint phải có thật nếu workflow có thể sai ở giữa đường.
  • Supporting files nên đặt ở references/ thay vì nhồi hết vào SKILL.md.

Anthropic cũng nhấn mạnh tư duy decision tree: chọn storage khác nhau tùy loại file, hoặc áp compliance trước khi hành động bên ngoài. Skill không chỉ là prompt hay hơn, mà là logic làm việc có trách nhiệm rõ ràng.

Test và iteration mới là phần đáng giá

Viết skill xong chưa đủ. Anthropic đẩy mạnh skill-creator với evals, benchmarking và multi-agent support để người viết có cách đo xem skill có thật sự ổn không. Mục tiêu rất thực tế: skill có trigger đúng lúc, workflow có chạy xong mà không cần sửa giữa chừng, và output có ổn định qua nhiều lần hay không.

Họ cũng nhấn mạnh trigger tuning. Description quá rộng sẽ gây false positive, description quá hẹp sẽ không bao giờ fire. Một cách test hợp lý là chạy 10-20 câu query đáng lẽ phải trigger, rồi lặp lại vài lần để xem output có ổn định không. via Claude

Phân phối và phạm vi dùng

Claude Code không chỉ có một chỗ đặt skill. Skills có thể sống ở enterprise, personal, project, plugin, và nested directory bên dưới worktree. Điều đó cho phép cùng một tổ chức có nhiều lớp hành vi: skill dùng chung toàn công ty, skill cho riêng một repo, và skill chỉ áp dụng cho một package con.

Trong Claude.ai, pre-built skills có sẵn cho PowerPoint, Excel, Word và PDF. Custom skills cũng có, nhưng là theo user và cần code execution. Với nhóm lớn, đây là điểm quyết định skill nào là tài sản cá nhân, skill nào là chuẩn tổ chức, và skill nào có thể chia sẻ rộng rãi. via Claude Platform Docs

Những lỗi sai thường gặp

Điều dễ hỏng nhất khi viết skill là tham. Một skill ôm quá nhiều nhiệm vụ sẽ bắt Claude đoán quá nhiều thứ cùng lúc. Một description chung chung sẽ làm skill kích hoạt sai thời điểm. Một skill chứa secrets sẽ biến thành rủi ro an ninh ngay lập tức.

Claude Code docs cũng nói rõ rằng skill descriptions có thể bị cắt ngắn khi thư viện skill lớn lên. Vì vậy, naming, description và structure không phải chi tiết trang trí. Chúng là thứ quyết định skill có sống được trong môi trường thật hay không. via Claude

Kết luận

Bản guide của Anthropic hữu ích vì nó không thần thánh hóa Skills. Nó chỉ ra đúng chỗ mà Skills đáng để dùng: khi workflow lặp lại, khi bạn muốn giữ chất lượng ổn định, khi MCP đã có nhưng chưa đủ hướng dẫn, và khi team cần một cách thống nhất để Claude làm việc thay vì mỗi người một kiểu.

Nếu cần rút ra một câu ngắn nhất, thì đây là nó: prompt là cách bạn nói chuyện với Claude, còn skill là cách bạn đóng gói năng lực làm việc của Claude. Khởi đầu hợp lý nhất vẫn là rất nhỏ: chọn một workflow, viết SKILL.md, tách phần dài sang references/, rồi test với vài câu thật. Làm đúng một skill trước khi nghĩ tới mười skill sau.

via guide chính thức · via Claude Code Docs · via Anthropic Engineering