Tạo & Đăng Kỹ năng
Xây dựng kỹ năng riêng và chia sẻ trên Marketplace Kỹ năng
Bất kỳ ai có tài khoản Claw Buff đều có thể tạo và đăng kỹ năng trên Marketplace Kỹ năng.
Tạo kỹ năng
Vào Marketplace Kỹ năng và nhấn Đăng kỹ năng, hoặc truy cập trực tiếp Trình chỉnh sửa Kỹ năng.
Trình chỉnh sửa
Trình chỉnh sửa kỹ năng có hai bảng:
Bảng trái — nội dung SKILL.md:
Viết hướng dẫn kỹ năng bằng Markdown. Đây là cốt lõi của kỹ năng — tài liệu prompt dạy agent cách thực hiện một tác vụ. Bạn cũng có thể tải lên tệp script tùy chọn (JS/TS) cho hành vi nâng cao.
Bảng phải — Metadata:
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Tên | Có | Tên hiển thị (tối thiểu 2 ký tự) |
| Mô tả | Có | Tóm tắt ngắn hiển thị trên thẻ |
| Danh mục | Có | Một trong: Phát triển, Năng suất, Giao tiếp, v.v. |
| Thẻ | Không | Nhãn phân cách bằng dấu phẩy để dễ tìm kiếm |
| Phiên bản | Có | Phiên bản ngữ nghĩa (ví dụ: 1.0.0) |
Viết SKILL.md tốt
Chất lượng kỹ năng hoàn toàn phụ thuộc vào độ rõ ràng của hướng dẫn. Theo cấu trúc sau:
---
name: my-skill
description: Kỹ năng này làm gì trong một câu
version: 1.0.0
---
# My Skill
## Tổng quan
Giải thích ngắn gọn agent có thể làm gì với kỹ năng này.
## Lệnh / Quy trình
Hướng dẫn từng bước mà agent nên tuân theo.
Cụ thể về công cụ nào sử dụng và theo thứ tự nào.
## Ví dụ
Hiển thị ví dụ đầu vào/đầu ra cụ thể để
agent hiểu hành vi mong đợi.
## Hạn chế
Những gì kỹ năng này không thể làm hoặc không nên thử.Kỹ năng tốt nhất là tập trung và cụ thể. Một kỹ năng làm tốt một việc hữu ích hơn một kỹ năng cố gắng bao quát mọi thứ. Hãy nghĩ "Trình đánh giá PR GitHub" chứ không phải "trợ giúp lập trình chung."
Lưu và Đăng
Bạn có hai lựa chọn:
- Lưu nháp — Lưu kỹ năng mà không đăng. Chỉ bạn mới thấy bản nháp. Hữu ích cho kỹ năng đang phát triển.
- Đăng — Gửi kỹ năng để xét duyệt và công khai trên marketplace sau khi được duyệt.
Quy trình xét duyệt
Khi bạn đăng kỹ năng, các bước sau xảy ra:
- Quét bảo mật tự động — Tệp script (nếu có) được quét tìm các mẫu độc hại đã biết (reverse shell, lấy cắp dữ liệu, đánh cắp thông tin xác thực).
- Trạng thái xét duyệt — Kỹ năng có script vượt qua quét được đặt thành "chờ duyệt." Kỹ năng không có script (chỉ SKILL.md) được tự động duyệt.
- Thông báo — Bạn sẽ được thông báo khi kỹ năng được duyệt hoặc từ chối. Kỹ năng bị từ chối kèm ghi chú giải thích lý do.
Kỹ năng chỉ chứa SKILL.md (không có tệp script) được tự động duyệt vì đó là tài liệu prompt thuần túy không có mã thực thi. Thêm script sẽ kích hoạt quy trình xét duyệt bảo mật.
Quản lý kỹ năng
Kỹ năng của tôi
Nhấn tab Kỹ năng của tôi trên trang marketplace để xem tất cả kỹ năng và trạng thái:
| Trạng thái | Ý nghĩa |
|---|---|
| Đã đăng (xanh lá) | Công khai trên marketplace, mọi người đều thấy |
| Chờ duyệt (vàng cam) | Đã gửi, đang chờ phê duyệt |
| Bị từ chối (đỏ) | Bị từ chối kèm ghi chú — chỉnh sửa và gửi lại |
| Chưa đăng (xám) | Bản nháp hoặc đã hủy đăng thủ công |
Chỉnh sửa
Nhấn vào bất kỳ kỹ năng nào để mở trong trình chỉnh sửa. Bạn có thể cập nhật:
- Nội dung SKILL.md
- Metadata (tên, mô tả, danh mục, thẻ)
- Số phiên bản
- Tệp script
Thay đổi đối với kỹ năng đã đăng có hiệu lực ngay sau khi lưu.
Hủy đăng
Để tạm thời xóa kỹ năng khỏi marketplace mà không xóa vĩnh viễn:
- Mở kỹ năng trong trình chỉnh sửa
- Nhấn Hủy đăng trong vùng nguy hiểm
Kỹ năng trở thành bản nháp. Bạn có thể đăng lại bất cứ lúc nào.
Xóa
Để xóa vĩnh viễn kỹ năng:
- Mở kỹ năng trong trình chỉnh sửa
- Nhấn Xóa trong vùng nguy hiểm
- Xác nhận xóa
Xóa là vĩnh viễn và không thể hoàn tác. Nếu người dùng đã cài đặt kỹ năng của bạn, bản sao đã cài vẫn tồn tại trên agent của họ, nhưng không có bản cập nhật nào trong tương lai.
Thực hành tốt nhất
- Viết hướng dẫn cụ thể. "Giúp người dùng với GitHub" quá mơ hồ. "Sử dụng
gh pr createđể tạo pull request với các thay đổi đã stage" mới có thể thực thi. - Bao gồm ví dụ. Cho agent thấy đầu vào và đầu ra tốt trông như thế nào. Điều này cải thiện đáng kể độ tin cậy của kỹ năng.
- Khai báo phụ thuộc. Nếu kỹ năng cần API key hoặc tệp nhị phân, hãy đề cập rõ ràng trong frontmatter và mô tả SKILL.md.
- Quản lý phiên bản có ý nghĩa. Tăng phiên bản khi thay đổi. Người dùng và nền tảng theo dõi lịch sử phiên bản.
- Kiểm tra trước khi đăng. Cài đặt kỹ năng trên agent của bạn và xác minh hoạt động đúng trước khi công khai.
- Viết mô tả rõ ràng. Đây là thứ người dùng nhìn thấy đầu tiên. Hãy cụ thể — kỹ năng này thực sự sẽ làm gì cho agent của họ?