Configuration and multi-file skills

• Tiêu chuẩn agentskills.io cung cấp cấu trúc cho các kỹ năng của Claude, với name và description là bắt buộc để xác định chức năng và thời điểm sử dụng một cách hiệu quả.
• Các trường tùy chọn như allowed_tools và model cho phép kiểm soát chi tiết về bảo mật và hiệu suất, giới hạn hành vi của kỹ năng và chỉ định mô hình Claude phù hợp.
• Sử dụng tiết lộ lũy tiến và script để tối ưu hóa cửa sổ ngữ cảnh của Claude, giữ cho skill.md gọn gàng và chỉ tải các tài liệu hoặc mã phức tạp khi thực sự cần thiết.

• Quy ước đặt tên Kỹ năng: Đặt name cho kỹ năng của bạn bằng chữ cái viết thường, số, dấu gạch nối, tối đa 64 ký tự và phải khớp với tên thư mục chứa kỹ năng đó.
• Mô tả Kỹ năng Hiệu quả: Viết description rõ ràng (tối đa 1024 ký tự) trả lời "kỹ năng này làm gì?" và "Claude nên sử dụng nó khi nào?", đồng thời bao gồm các cụm từ kích hoạt liên quan.
• Hạn chế Công cụ với allowed_tools: Sử dụng trường allowed_tools để giới hạn các công cụ mà Claude có thể sử dụng khi kỹ năng đang hoạt động, tăng cường bảo mật và kiểm soát hành vi của kỹ năng.
• Chỉ định Mô hình Claude: Dùng trường model để chỉ định mô hình Claude cụ thể sẽ được sử dụng cho kỹ năng đó, tối ưu hóa hiệu suất hoặc phù hợp với yêu cầu của tác vụ.
• Tối ưu hóa Cửa sổ Ngữ cảnh bằng Tiết lộ Lũy tiến: Đặt các hướng dẫn thiết yếu vào skill.md (giữ dưới 500 dòng) và liên kết đến các tệp hỗ trợ (tài liệu tham khảo, tài sản) được tổ chức trong các thư mục riêng biệt, chỉ tải khi cần.
• Sử dụng Mã Thực thi (Script): Đặt mã thực thi trong thư mục scripts; chúng có thể chạy mà không cần tải nội dung vào ngữ cảnh, giúp tiết kiệm token và đảm bảo hoạt động nhất quán.
• Tăng cường Kích hoạt Kỹ năng: Nếu kỹ năng không được kích hoạt như mong đợi, hãy thêm nhiều từ khóa và cụm từ kích hoạt vào description để cải thiện khả năng khớp của Claude với các lời nhắc.

• skill — kỹ năng
• name — tên định danh
• description — mô tả
• allowed_tools — công cụ được phép
• model — mô hình (Claude)
• context window — cửa sổ ngữ cảnh
• progressive disclosure — tiết lộ lũy tiến
• executable code / scripts — mã thực thi / tập lệnh
• trigger phrases — cụm từ kích hoạt
• supporting files — tệp hỗ trợ

Giới thiệu về Kỹ năng và Tiêu chuẩn agentskills.io

Một kỹ năng cơ bản chỉ hoạt động với một name (tên) và description (mô tả), nhưng dưới đây là một số mẹo nâng cao khác có thể làm cho các kỹ năng của bạn thực sự hiệu quả trong Claude Code. Tiêu chuẩn mở agentskills.io có nhiều trường có sẵn. Chúng ta đã xem qua name, dùng để định danh kỹ năng của bạn, chỉ sử dụng các chữ cái viết thường, số và dấu gạch nối, tối đa 64 ký tự và phải khớp với tên thư mục của bạn. Một description cũng là bắt buộc, cho Claude biết khi nào nên sử dụng kỹ năng đó. Trường này có tối đa 1024 ký tự và là trường quan trọng nhất; Claude sử dụng nó để khớp với các lời nhắc.

Các Trường Tùy chọn Nâng cao và Mô tả Hiệu quả

Chúng ta cũng có thể thêm các trường tùy chọn khác. Một trong số đó là trường allowed_tools hạn chế những công cụ mà Claude có thể sử dụng khi kỹ năng đang hoạt động. Trường model chỉ định mô hình Claude nào sẽ được sử dụng cho kỹ năng đó.

Hãy cố gắng mô tả rõ ràng với các hướng dẫn của bạn. Ví dụ, nếu ai đó nói công việc của tôi là giúp đỡ chó, tôi sẽ không biết phải làm gì. Vì vậy, chúng ta phải cho rằng Claude cũng sẽ nghĩ như vậy. Một description tốt trả lời hai câu hỏi: kỹ năng này làm gì? và Claude nên sử dụng nó khi nào? Nếu mô tả công việc này được đưa cho tôi, tôi sẽ cảm thấy tự tin hơn một chút rằng mình có thể hoàn thành công việc. Nếu kỹ năng của bạn không được kích hoạt, hãy thêm nhiều từ khóa hơn khớp với cách bạn diễn đạt các yêu cầu.

Kiểm soát Công cụ với allowed_tools

Đôi khi bạn muốn một kỹ năng chỉ có thể đọc tệp chứ không sửa đổi chúng. Điều này có thể áp dụng cho các quy trình làm việc nhạy cảm về bảo mật, các tác vụ chỉ đọc hoặc hơn thế nữa. Chúng ta có trường allowed_tools để biến điều này thành hiện thực. Khi kỹ năng này hoạt động, Claude chỉ có thể sử dụng những công cụ đó mà không cần hỏi quyền. Không chỉnh sửa, không ghi, không có lệnh bash. Nếu bạn bỏ qua allowed_tools, kỹ năng sẽ không hạn chế bất cứ điều gì; Claude sử dụng mô hình quyền bình thường của nó.

Quản lý Hiệu quả Cửa sổ Ngữ cảnh với Tiết lộ Lũy tiến

Các kỹ năng chia sẻ cửa sổ ngữ cảnh của Claude với cuộc hội thoại của bạn. Khi Claude muốn sử dụng một kỹ năng, nó sẽ quyết định tải nội dung của kỹ năng đó vào ngữ cảnh. Tuy nhiên, đôi khi bạn sẽ cần một số tài liệu tham khảo, ví dụ hoặc một số script tiện ích (utility scripts) được yêu cầu bởi kỹ năng. Nhưng việc nhồi nhét tất cả vào một tệp văn bản 20.000 dòng có nghĩa là bạn chiếm rất nhiều không gian trong cửa sổ ngữ cảnh. Và hãy thành thật mà nói, việc duy trì nó không hề dễ dàng.

Đây là lúc tiết lộ lũy tiến (progressive disclosure) phát huy tác dụng. Đặt các hướng dẫn thiết yếu của bạn vào skill.md và tài liệu tham khảo chi tiết vào các tệp riêng biệt mà Claude chỉ đọc khi cần. Tiêu chuẩn mở cũng đề xuất có một thư mục scripts cho mã thực thi (executable code), thư mục references cho tài liệu bổ sung và thư mục assets cho hình ảnh, mẫu (templates) hoặc các tệp dữ liệu khác có liên quan đến kỹ năng đó. Sau đó, trong skill.md, liên kết đến các tệp hỗ trợ (supporting files). Ở đây, Claude chỉ đọc architecture.md khi ai đó hỏi về thiết kế hệ thống (system design). Nếu họ hỏi nơi để thêm một thành phần (component) thì nó sẽ không bao giờ được tải. Điều này giống như việc có một mục lục trong cửa sổ ngữ cảnh thay vì cố gắng đưa toàn bộ tài liệu vào đó. Giữ tệp skill.md dưới 500 dòng. Nếu bạn vượt quá giới hạn đó, có thể nên xem xét liệu nội dung này có nên được chia thành các nội dung khác nhau hay không.

Sử dụng Script và Tóm tắt Các Khuyến nghị

Script trong thư mục kỹ năng của bạn có thể chạy mà không cần tải nội dung của chúng vào ngữ cảnh. Script thực thi và chỉ đầu ra mới tiêu thụ token. Hãy yêu cầu Claude chạy script chứ không phải đọc nó. Điều này rất hữu ích cho việc xác thực môi trường (environment validation), chuyển đổi dữ liệu (data transformations) cần nhất quán, các hoạt động đáng tin cậy hơn với mã đã kiểm thử (tested code) so với mã được tạo (generated code).

Các kỹ năng hỗ trợ các trường metadata: name và description là bắt buộc. allowed_tools hạn chế các công cụ có sẵn và model chỉ định mô hình Claude nào sẽ sử dụng. Các description cần các hành động cụ thể và cụm từ kích hoạt (trigger phrases) để khớp một cách đáng tin cậy. Đối với các kỹ năng lớn hơn, hãy sử dụng tiết lộ lũy tiến. Giữ tệp skill.md của bạn dưới 500 dòng và liên kết đến các tệp hỗ trợ chỉ tải khi cần. Script có thể thực thi mà không cần tải nội dung của chúng, giúp ngữ cảnh hiệu quả.