Cài đặt và quản lý kỹ năng

Hướng dẫn này chỉ cho bạn cách lấp đầy một không gian làm việc bằng các kỹ năng từ GitHub: thêm một kho mã làm nguồn, cài đặt những kỹ năng bạn muốn từ đó và giữ chúng luôn mới theo thời gian.

Điều quan trọng cần biết trước khi bắt đầu: một kho mã nguồn là thứ không đáng tin. Tên, mô tả và số sao của nó do người sở hữu viết ra. Tín hiệu an toàn duy nhất mà Control Center tin tưởng là kết luận quét antivirus, thứ mà mọi lượt cài đặt đều đi qua trước khi bất cứ thứ gì chạm tới đĩa hoặc prompt của agent. Nếu bạn muốn hiểu lý do, hãy đọc mục kỹ năng trong mô hình agent; trang này chỉ tập trung vào việc thực hiện.

Kỹ năng nằm tại Cài đặt → Không gian làm việc → Kỹ năng (/workspaces/<id>/settings/workspace/skills). Chúng có phạm vi theo không gian làm việc: những kỹ năng bạn cài ở đây chỉ thuộc không gian làm việc này. Trang có hai thẻ: Đã cài (kỹ năng cục bộ, gồm cả trình soạn thảo Skill mới) và Nguồn (danh mục GitHub). Cả hai thao tác ghi đều đi qua cùng một cổng quét.

Thêm kho kỹ năng

Mở Cài đặt → Không gian làm việc → Kỹ năng và chuyển sang thẻ Nguồn.
Nhấn Thêm kho.
Dán URL kho mã GitHub, ví dụ https://github.com/anthropics/skills, rồi xác nhận.

Máy chủ kiểm tra rằng kho mã tồn tại và hiển thị được với thông tin xác thực của nó, rồi thêm nó vào thanh bên trái. Không có cửa hàng được tuyển chọn nào ở giữa: bất kỳ kho mã GitHub nào cũng dùng được, nghĩa là uy tín do bạn tự đánh giá — số sao là bằng chứng, không bao giờ là bảo đảm.

Kỹ năng của một kho mã là những thư mục chứa tệp SKILL.md (tối đa ba cấp, cộng thêm bố cục chợ plugin của Claude plugins/<plugin>/skills/<skill>, bỏ qua các cây phụ thuộc và vendor). Nếu sau đó lưới báo rằng kho mã không có kỹ năng nào, thì đúng là như vậy: không có thư mục nào trong đó khớp với quy ước kỹ năng.

Xem xét kỹ năng trước khi cài đặt

Chọn một kho mã trong thanh bên; các kỹ năng của nó hiện ra thành một lưới ở bên phải, với ô lọc phía trên để thu hẹp danh mục theo tên, mô tả hoặc slug. Nhấp vào một thẻ để mở chế độ xem chi tiết. Nó hiển thị ba thứ:

README, được kết xuất dưới dạng markdown — tệp README.md của thư mục kỹ năng, hoặc phần thân SKILL.md khi không có README.
Bản xem trước kết quả quét — kết luận (pass, warn hoặc quarantine), các khả năng mà nội dung kỹ năng khai báo (chạy shell, ghi tệp, truy cập mạng…) và mọi phát hiện mà trình quét ghi nhận.
Số lượng tệp — một lượt cài đặt ghi toàn bộ thư mục của kỹ năng, không chỉ tệp SKILL.md của nó.

Bản xem trước quét đúng những byte mà một lượt cài đặt sẽ ghi, nên kết luận bạn thấy chính là kết luận mà lượt cài đặt nhận được; không có gì bị đánh giá lại sau lưng bạn.

Cài đặt một kỹ năng

Mở chế độ xem chi tiết của kỹ năng.
Đọc kết luận quét. Với kết luận warn hoặc pass, nhấn Cài đặt.
Với kết luận quarantine, nút cài đặt bị vô hiệu hóa cho đến khi bạn đánh dấu Tôi hiểu rủi ro — vẫn cài. Thao tác ghi đè đó được ghi nhận, không phải mặc định.

Lượt cài đặt ghi thư mục của kỹ năng vào không gian làm việc, ghi một ghim trong skills-lock.json (kho mã nguồn, đường dẫn, commit mà nó đến từ đó và hash nội dung), và kỹ năng trở nên khả dụng cho các agent trong không gian làm việc. Một thẻ đánh dấu Tên đang được dùng nghĩa là một kỹ năng khác đã chiếm tên đó ở cục bộ — hãy gỡ cài đặt kỹ năng đó trước.

Cập nhật kỹ năng theo thời gian

Các thẻ của kỹ năng đã cài mang huy hiệu: Đã cài, hoặc Có bản cập nhật khi kho mã đã vượt qua commit bạn đã ghim. Mở chế độ xem chi tiết và nhấn Cập nhật để tải lại tại commit mới. Một lượt cập nhật đi qua đúng cổng quét như một lượt cài đặt — kỹ năng có phiên bản mới bị cách ly sẽ bị từ chối và phiên bản bạn đang có vẫn giữ nguyên. Hash của phiên bản cũ được giữ làm tham chiếu khôi phục trong tệp lock.

Gỡ cài đặt một kỹ năng, xóa một kho mã

Gỡ cài đặt (trong chế độ xem chi tiết của kỹ năng đã cài, hoặc xóa trong thẻ Đã cài) loại bỏ thư mục của kỹ năng và ghim lock của nó cùng lúc — một kỹ năng đã gỡ cài đặt không để lại gì.

Xóa một kho mã khỏi thanh bên chỉ loại bỏ danh mục: những kỹ năng bạn đã cài từ nó vẫn được cài và vẫn cập nhật, bởi một ghim ghi lại kho mã theo tên chứ không theo tham chiếu tới mục nguồn. Hãy thêm lại kho mã nếu bạn muốn duyệt nó lần nữa.

Gọi một kỹ năng

Các kỹ năng được gọi dưới không gian tên riêng của chúng, nên chúng không bao giờ đụng với các lệnh slash tích hợp (/plan, /goal, /loop, /compact):

/skill:<name> — một kỹ năng đã cài trong không gian làm việc này, hoặc được gắn vào agent
/skill:<repo>:<name> — một kỹ năng do một kho mã đã checkout trong space này cung cấp

Một tên trần không phải tích hợp vẫn được phân giải, dành cho những tin nhắn được viết trước khi không gian tên tồn tại. /skill:plan là thứ tiếp cận một kỹ năng tên plan; /plan luôn là lệnh tích hợp.

Kỹ năng theo phạm vi kho mã

Một kho mã đã checkout có thể cung cấp các kỹ năng của riêng nó, trong .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ hoặc skills/. Những kỹ năng đó không được cài qua trang này. Một agent chỉ mang theo các kỹ năng của kho mã mà nó đang làm việc trong đó; chúng đổi khi nó chuyển đi. Khung soạn tin không bị giới hạn phạm vi như vậy: /skill:<repo>:<name> tiếp cận bất kỳ kho mã nào trong space.

Kỹ năng của kho mã đi qua đúng đợt quét fail-closed (pass / warn / quarantine) trước khi frontmatter của chúng chạm tới một prompt. warn được chấp nhận; quarantine bị giữ lại, không có quyền ghi đè của người vận hành trên đường đó.

Xem Kỹ năng theo phạm vi kho mã và Lệnh slash.

Hướng dẫn liên quan

Khái niệm liên quan

Mô hình agent