Claude Skills được giải thích: Ba cấp độ của cơ chế tiết lộ dần

Một Claude Skill, về mặt vật lý, là một thư mục. Không phải một dịch vụ được host, không phải một tệp nhị phân, không phải một khối văn bản bạn dán ở đầu cuộc trò chuyện — mà là một thư mục chứa tệp SKILL.md và bất cứ thứ gì khác mà công việc cần. Gần như mọi điều thú vị về Skills đều xuất phát từ quyết định đó, bởi vì một thư mục là thứ mà agent có thể mở một cách có chọn lọc. Một prompt thì không thể được mở một cách có chọn lọc. Nó hoặc nằm trong cuộc trò chuyện, hoặc không.

Tài liệu của Anthropic mô tả cách sắp xếp này được tổ chức giống như một hướng dẫn nhập môn mà bạn sẽ tạo cho một thành viên mới trong nhóm, và phép so sánh này còn đúng xa hơn vẻ bề ngoài ban đầu. Không ai đọc một hướng dẫn nhập môn từ đầu đến cuối trước khi bắt đầu làm việc. Họ đọc trang khớp với câu hỏi trước mắt, và tin rằng phần còn lại vẫn ở đó khi họ cần. Một kỹ năng được xây dựng trên cùng một canh bạc: rằng phần lớn một quy trình có thể ở lại trên đĩa trong phần lớn thời gian.

Hệ thống tệp trước, khả năng sau

Claude hoạt động trong một máy ảo có quyền truy cập hệ thống tệp. Đó là điều kiện tiên quyết để một kỹ năng là một thư mục thay vì một mục cấu hình, vì nó cho phép tác nhân liệt kê một thư mục, đọc một tệp và theo một tham chiếu đến tệp khác bằng chính các thao tác mà một người sẽ dùng. Bên trong đó, một kỹ năng đóng gói hướng dẫn, siêu dữ liệu và các tài nguyên tùy chọn như tập lệnh và mẫu.

Kết quả là một năng lực lớn hơn bất kỳ tệp đơn lẻ nào trong thư mục. Các hướng dẫn cho biết cách thực hiện nhiệm vụ. Một tập lệnh đi kèm có thể thực hiện một phần của việc đó mà không cần được mô tả bằng văn xuôi. Một tài liệu tham chiếu có thể chứa nội dung được tra cứu thay vì phải ghi nhớ. Điều khiến ba thứ đó trở thành một hệ thống thay vì một đống là thứ tự mà chúng trở nên hiển thị, tức là phần mà Anthropic gọi là progressive disclosure — tải thông tin theo từng giai đoạn khi cần thay vì tiêu tốn ngữ cảnh ngay từ đầu.

Cấp 1: hai trường luôn được tải

Mỗi skill đều bắt đầu bằng phần frontmatter YAML chứa tên và mô tả. Claude tải siêu dữ liệu đó khi khởi động và đưa nó vào prompt hệ thống. Đây là phần duy nhất của skill hiện diện trước khi có ai yêu cầu bất cứ điều gì, và cho đến khi một skill được kích hoạt, chỉ tên và mô tả của nó chiếm chỗ trong ngữ cảnh.

Phần mô tả đang đảm nhận ba vai trò cùng lúc, và việc tách chúng ra sẽ giải thích vì sao rất nhiều kỹ năng bị âm thầm bỏ qua. Nó là một nhãn, cho biết thứ đó được gọi là gì. Nó là một mục chỉ mục, đoạn văn bản mà một yêu cầu được so khớp với khi Claude quyết định xem kỹ năng có liên quan hay không. Và nó là một tuyên bố về phạm vi, đó là lý do hướng dẫn của Anthropic nói rằng nó phải nêu rõ cả kỹ năng làm gì và khi nào nên dùng nó. Một phần mô tả chỉ làm được điều đầu tiên sẽ không cho bộ so khớp bất cứ thứ gì để so khớp.

Hãy lấy hai phiên bản của cùng một kỹ năng. Một bản được mô tả là điền và xác thực các biểu mẫu PDF, được dùng khi một yêu cầu liên quan đến việc hoàn thành hoặc kiểm tra một biểu mẫu PDF. Bản còn lại được mô tả là hỗ trợ xử lý tài liệu. Bản đầu nêu rõ một hành động và một tình huống; bản sau không nêu cả hai. Một kỹ năng mà phần mô tả không nêu cả hai sẽ nằm im trên đĩa mà không được đọc, trong khi tác nhân thực hiện công việc theo cách dài dòng hơn — không phải vì kỹ năng đó thất bại, mà vì nó chưa bao giờ được tìm thấy.

Cấp độ 2: phần nội dung, đọc khi phần mô tả khớp

Khi một yêu cầu khớp với phần mô tả, tầng thứ hai sẽ mở ra: phần thân của SKILL.md. Đó là quy trình — các quy trình làm việc, thực tiễn tốt nhất, hướng dẫn — và nó được viết cho một agent đã quyết định rằng kỹ năng này là công cụ phù hợp cho công việc. Đây là nơi một nhóm ghi lại những bước mà nếu không thì họ sẽ lặp lại trong mọi cuộc trò chuyện, và cũng là nơi chứa các chỉ dẫn dẫn đến tài liệu chuyên sâu hơn.

Thứ tự ở đây quan trọng không kém gì ở cấp 1. Phần thân không được tải khi khởi động, và cũng không được tải để phòng hờ. Nó đến sau khi một quyết định đã được đưa ra, nghĩa là quyết định đó phải có thể đưa ra chỉ dựa vào cấp 1. Một kỹ năng có mô tả mơ hồ không có cách nào cứu vãn ở cấp 2, vì cấp 2 không bao giờ được đọc.

Cấp độ 3: những tệp mở ra vì có thứ gì đó đã trỏ đến chúng

Cấp thứ ba là phần còn lại của thư mục: các tệp bổ sung được tham chiếu từ SKILL.md. Ví dụ của Anthropic là một tệp FORMS.md chứa hướng dẫn nâng cao về điền biểu mẫu, được giữ tách khỏi hướng dẫn chính để các hướng dẫn đó vẫn ngắn gọn và thông tin chi tiết chỉ có sẵn khi một tác vụ cần đến. Các tập lệnh và mẫu cũng thuộc cấp này.

Hiệu ứng về mặt cấu trúc là một kỹ năng có thể mang rất nhiều tài liệu mà không cần mang tất cả cùng một lúc. Một thư mục có thể chứa một tệp hướng dẫn chính, một tài liệu tham chiếu chi tiết, một bộ mẫu và một tập lệnh, và một tác vụ nhất định có thể chỉ chạm đến một trong số đó. Bất cứ thứ gì không được trỏ tới sẽ nằm lại trên đĩa, và đĩa không phải là tài nguyên khan hiếm trong một agent. Ngữ cảnh mới là.

Đó cũng là điểm mà định dạng này nâng bỏ giới hạn trần mà các prompt thường gặp phải. Một prompt phải đủ ngắn để còn đáng để dán. Tài liệu đóng gói của một skill bị giới hạn bởi những gì một thư mục có thể chứa, vì phần duy nhất đến được với mô hình là phần mà tác vụ thực sự chạm tới.

Vì sao thứ tự chính là thiết kế, không phải chi tiết phụ

Có ba hệ quả kéo theo, và cùng với nhau, chúng chính là lý do khiến điều này đáng để hiểu sâu chứ không chỉ là biết đơn thuần.

• Ngữ cảnh là một ngân sách, và nội dung luôn được tải là một chi phí cố định.Mọi thứ trong lời nhắc hệ thống đều phải trả giá trong mỗi yêu cầu, kể cả những yêu cầu không liên quan gì đến kỹ năng đó. Hiển thị dần dần biến một chi phí cố định thành chi phí có điều kiện: luôn có mô tả, hướng dẫn khi phù hợp, tài liệu tham chiếu khi được tham chiếu.

• Phần mô tả là một giao diện. Đây là phần duy nhất của một kỹ năng chắc chắn được nhìn thấy, vì vậy đây là nơi tác giả phải nghĩ về việc kích hoạt chứ không chỉ về nội dung.

• Một kỹ năng có ba tốc độ bảo trì. Siêu dữ liệu thay đổi khi kỹ năng nên kích hoạt khác đi, phần thân thay đổi khi quy trình thay đổi, và tài liệu tham chiếu thay đổi khi nguồn tài liệu nền tảng thay đổi. Giữ chúng tách biệt giúp một bản cập nhật tài liệu tham chiếu không biến thành việc viết lại các hướng dẫn.

Chi phí là hình ảnh phản chiếu của lợi ích. Mỗi ranh giới cấp độ là nơi mô hình phải đưa ra quyết định một cách chính xác. Một mô tả quá hẹp nghĩa là kỹ năng không bao giờ được kích hoạt và thư mục trở thành gánh nặng vô ích. Một mô tả quá rộng nghĩa là nó kích hoạt trên công việc mà nó không được tạo ra để làm, và các hướng dẫn của nó trở thành một khoản thuế đối với những tác vụ không liên quan. Việc tiết lộ dần dần khiến phần mô tả trở thành yếu tố chịu lực theo cách mà một lời nhắc dài, luôn hiện diện, không bao giờ làm được.

Anthropic đã và đang cung cấp những gì, và kỹ năng của chính bạn đến từ đâu

Anthropic cung cấp các Skill dựng sẵn cho PowerPoint, Excel, Word và PDF — bài thuyết trình, bảng tính, tài liệu và đầu ra PDF đã định dạng. Chúng có sẵn trên claude.ai, Claude API, Claude Platform trên AWS và Microsoft Foundry, với lưu ý rằng trên Foundry, chúng yêu cầu triển khai Hosted on Anthropic.

Đó là cách nhanh nhất để thấy cơ chế thay vì đọc về nó. Thứ tự tải giống hệt với bất kỳ thứ gì bạn tự viết; sự khác biệt giữa một kỹ năng dựng sẵn và một kỹ năng tùy chỉnh là ai đã tạo thư mục, chứ không phải cách nó đến được với mô hình.

Skills tùy chỉnh có thể được tạo trong Claude Code, tải lên qua Claude API hoặc thêm vào trong phần cài đặt của claude.ai. Những lợi ích mà Anthropic nêu ra cho chúng đúng là những gì bạn kỳ vọng ở bất kỳ thứ gì có thể tái sử dụng: chuyên biệt hóa Claude cho các tác vụ theo lĩnh vực, tạo hướng dẫn một lần thay vì lặp lại, và kết hợp nhiều skill cho công việc gồm nhiều bước. Điều cuối cùng trong số đó bắt nguồn trực tiếp nhất từ kiến trúc, bởi vì nếu mỗi skill là một thư mục mở ra theo yêu cầu, thì một chồng skill chỉ tốn rất ít cho đến khi công việc thực sự cần đến chúng.

Một kỹ năng không phải là một lời nhắc, và cũng không phải là một trình kết nối.

Ba thứ bị gộp lẫn trong cuộc trò chuyện, và thứ tự nạp giúp dễ nắm giữ những khác biệt.

Prompt thuộc cấp độ hội thoại. Nó hiện diện ngay từ lượt đầu tiên, nhuộm màu mọi thứ trong hội thoại đó và biến mất cùng với hội thoại. Kỹ năng thì theo nhu cầu: nó tồn tại trước khi hội thoại bắt đầu, phần lớn nó không bao giờ đi vào hội thoại cả, và phần đến được là nhờ một mô tả đã khớp. Đó là khác biệt giữa việc bảo một tác nhân cách hành xử và trao cho nó một thứ mà nó có thể tiếp thu.

Một connector là nói về khả năng với tới. Connector là quyền truy cập ứng dụng, nghĩa là chúng quyết định tác nhân có thể chạm tới gì; một skill quyết định cách tác nhân nên làm điều gì đó khi đã chạm tới được nó. Một nhóm có thể có những connector xuất sắc mà vẫn tạo ra tài liệu không nhất quán, vì quyền truy cập không phải là quy trình. Nhóm đó cũng có thể có những skill xuất sắc mà vẫn không nhìn thấy dữ liệu, vì quy trình không phải là quyền truy cập.

Tài liệu của Anthropic coi Skills và Model Context Protocol là những lớp khác nhau, và cơ chế ba cấp cho thấy vì sao sự tách biệt này rõ ràng. Thứ tự tải nói về thời điểm thông tin đến, không phải nơi thông tin bắt nguồn.

Vị trí phù hợp của khoản quyên góp, trong một đoạn văn.

Ngày 22 tháng 10 năm 2026, Anthropic đã trao tặng tiêu chuẩn Agent Skills cho Agentic AI Foundation thuộc Linux Foundation — bao gồm tên gọi, logo, tổ chức GitHub và tên miền agentskills.io — với các kỹ sư đến từ Anthropic, Google, OpenAI và các công ty khác duy trì nó với tư cách cá nhân. Không điều nào trong số đó làm thay đổi cơ chế nêu trên. Định dạng thư mục, phần frontmatter YAML, thứ tự tải và các kỹ năng tài liệu dựng sẵn vẫn y nguyên như ngày hôm trước. Điều đã thay đổi là ai sở hữu tên gọi, một yếu tố có ý nghĩa rất lớn đối với sự ổn định lâu dài của một tiêu chuẩn, nhưng hoàn toàn không ảnh hưởng đến cách bạn viết một kỹ năng vào chiều nay.

Đọc một kỹ năng trước khi bạn cài đặt nó

Nếu ba cấp độ là kiến trúc, chúng cũng tạo nên một danh sách kiểm tra đánh giá ngắn gọn. Hãy đọc phần mô tả trước, vì nó quyết định liệu có bất kỳ điều gì khác xảy ra hay không: nó phải nêu rõ kỹ năng làm gì và khi nào nên dùng kỹ năng đó, bằng những từ ngữ mà một yêu cầu có khả năng sẽ dùng. Đọc SKILL.md thứ hai, vì đó là quy trình mà tác nhân sẽ tuân theo, và nó phải đọc giống như hướng dẫn cho một đồng nghiệp có năng lực chứ không phải bản tóm tắt về những gì bạn hy vọng sẽ xảy ra. Đọc những gì nó tham chiếu đến thứ ba. Sau đó đọc các tập lệnh.

Mục cuối cùng đó không phải là hoang tưởng. Định dạng này cho phép một skill mang theo hướng dẫn cùng với các tài nguyên tùy chọn, và tài nguyên có thể bao gồm mã thực thi. Vì vậy, một skill bạn cài đặt không chỉ là văn bản định hình cuộc trò chuyện; nó là một thư mục mà một tác nhân có năng lực sẽ mở các tệp từ đó và hành động dựa trên chúng. Mô hình từng cấp độ cho bạn biết chính xác nơi cần xem xét, điều mà hầu hết những thứ được cài đặt không cung cấp được.

Có một ranh giới đáng nói rõ cho những độc giả đến từ chính các trang của chúng tôi. OrcaRouter định tuyến các lệnh gọi mô hình, và chúng tôi không tự vận hành ứng dụng nào của Anthropic hay các bề mặt skill của nó — skill chạy ở nơi có hệ thống tệp của tác nhân, và đó không phải lớp của chúng tôi. Việc chúng tôi làm nằm bên dưới lựa chọn mô hình: hơn 200 mô hình sau một khóa tương thích OpenAI, giá niêm yết của nhà cung cấp được chuyển nguyên không cộng thêm, và tự động chuyển đổi dự phòng giữa các nhà cung cấp khi một bên không khả dụng. Skill quyết định cách một tác vụ nên được thực hiện. Router quyết định mô hình nào thực hiện nó, và không lớp nào cần biết quá nhiều về lớp kia.

Tiết lộ dần dần phản ánh trung thực về ràng buộc mà nó giải quyết. Ngữ cảnh là hữu hạn, các quy trình thì dài, và phần lớn nội dung của bất kỳ quy trình nào đều không liên quan đến nhiệm vụ trước mắt bạn. Một tên, một phần thân và một tập tệp không phải là một thiết kế phức tạp; đó là thiết kế nhỏ nhất cho phép một tác nhân mang theo lượng lớn kiến thức trong khi chỉ nắm giữ phần mà nó cần.

Đó là lý do vì sao dòng hệ trọng nhất trong một skill được xây dựng tốt cũng là dòng ngắn nhất. Mọi thứ khác trong thư mục là một thư viện. Phần mô tả là danh mục thẻ, và khi danh mục sai, thư viện cũng coi như không tồn tại.