SKILL.md) dạy CloudThinker cách nhóm bạn làm một việc, chẳng hạn checklist review, thứ tự leo thang hay quy ước gắn tag. Bạn viết một lần trong More → Workspace settings → Skills, và agent áp dụng ở mọi nơi bạn cho phép, nên không ai phải gõ lại cùng một quy tắc vào từng prompt.
Khi nào nên viết skill
Hãy viết skill khi thấy mình nhắc đi nhắc lại cùng một chỉ dẫn. Một vài ví dụ điển hình:
Skill cho agent biết cách hành động; tài liệu tham khảo để tra cứu thuộc về knowledge base. Xem khi nào nên dùng skill.
Điều kiện tiên quyết
- Vai trò phù hợp với cách tạo bạn chọn. Developer và Viewer đọc được skill nhưng không thấy nút + hay New Skill. Xem vai trò.
- Nếu bạn định tự viết
SKILL.mdhoặc tải lên một gói, hãy đọc qua định dạng skill.
Tạo skill
1
Mở Skills
Vào More → Workspace settings → Skills. Trang liệt kê các skill của workspace ở bên trái và hiển thị skill đang chọn ở bên phải.
2
Mở menu tạo skill mới
Nhấn nút + cạnh Search skills, ở đầu danh sách skill. (Khi chưa có skill nào, trang hiển thị nút New Skill thay thế.) Chọn một cách tạo trong menu. Dùng tab bên dưới tương ứng với cách bạn chọn.
3
Tạo skill
- Create with CloudThinker
- Write skill instructions
- Upload zip file
- Browse Skills Hub
Phù hợp nhất cho skill đầu tiên. CloudThinker phỏng vấn bạn và soạn file.
- Nhấn Create with CloudThinker. Một cuộc chat mở ra với lệnh
/create-skillđã điền sẵn. - Gửi lệnh, rồi trả lời các câu hỏi. Mô tả một quy tắc cụ thể mà nhóm bạn áp dụng, kèm ví dụ.
- Xem bản nháp CloudThinker đề xuất. Khi được hỏi Proceed with creating this skill?, chọn Yes, create it, hoặc chọn Change something và nói rõ cần đổi gì. Sau đó mở More → Workspace settings → Skills để xác nhận skill đã có, đang bật và khả dụng trong Chat.
/create-skill. Đây là cuộc chat bình thường nên có tốn credit. Chưa có gì được lưu cho đến khi bạn chọn Yes, create it, nên dừng giữa chừng sẽ không để lại skill dở dang.Chọn nơi áp dụng skill
Skill mới bật sẵn và chỉ khả dụng trong Chat. Các khu vực khác giữ trạng thái tắt cho đến khi bạn bật, nên một quy tắc chưa kiểm thử kỹ không thể làm thay đổi các lượt review hay công việc xử lý sự cố.1
Chọn skill
Trong More → Workspace settings → Skills, nhấn vào skill trong danh sách.
2
Đánh dấu các khu vực trong Available in
Đánh dấu từng nơi skill cần áp dụng:
Để tạm dừng skill, hãy dùng công tắc thay vì bỏ đánh dấu mọi ô.
3
Xác nhận công tắc đang bật
Công tắc cạnh tên skill dùng để bật hoặc tắt skill. Skill bị tắt vẫn được lưu nhưng không agent nào dùng.
Kiểm thử skill
1
Chạy một việc mà quy tắc có tác dụng
Thử cả hai cách, mỗi cách trong một cuộc chat mới. Với ví dụ Chạy mà không gọi tên:Hãy dán ghi chú như trên để agent có nội dung thật. Thiếu ghi chú hoặc công cụ theo dõi công việc đã kết nối, agent không có gì để báo cáo và có thể đặt câu hỏi ngược lại. Kết quả mong đợi gồm ba phần, Wins, Blockers và Next steps, mỗi phần một gạch đầu dòng kèm người phụ trách.Trạng thái thành công: hoạt động của agent hiển thị bước Load Skill, và cả hai câu trả lời đều theo skill (ở đây là bố cục wins, blockers, next steps) mà bạn không phải nhắc lại quy tắc.
weekly-status-report trong tab Write skill instructions:Gọi theo tên (gõ / rồi chọn skill từ menu):2
Mở rộng khi skill đã chạy tốt
Sau vài kết quả tốt trong Chat, hãy đánh dấu Review, Incident hoặc Assessment và kiểm tra lượt chạy kế tiếp ở đó. Review không có môi trường thử riêng, nên hãy kiểm thử như sau:
- Đánh dấu Review.
- Mở một pull request nhỏ trong repository nháp mà Review đang theo dõi. Đừng mở dưới dạng draft: draft chỉ được review khi đánh dấu sẵn sàng. Hoặc bình luận
@cloudthinker-ai reviewtrên một pull request có sẵn. - Kiểm tra lượt review có theo skill không. Nếu không, hãy bỏ đánh dấu Review ngay, vì mọi repository đều dùng skill khi ô này còn được đánh dấu.
Sửa, tải xuống hoặc xóa skill
Chọn skill, rồi dùng các nút biểu tượng cạnh Available in. Di chuột lên từng nút để xem tên.
Audit Logs ghi lại ai đã tạo, tải lên, sửa, đổi phạm vi áp dụng hoặc xóa skill trong More → Workspace settings → Skills, nhưng chỉ trên gói Scale và Enterprise, và không ghi skill do agent lưu từ chat. Trên các gói khác, không có gì ghi lại thay đổi của skill, nên hãy lưu file
.zip của mọi skill trong một repository và tải thay đổi lên từ đó.
Khắc phục sự cố
This skill name is already in use
This skill name is already in use
Một skill khác trong workspace đã dùng tên này. Hãy chọn tên khác, hoặc tải lên file
.zip và chọn Replace để ghi đè skill có sẵn.This skill name is reserved
This skill name is reserved
Tên này trùng với một skill tích hợp sẵn của CloudThinker, chẳng hạn
pdf, docx hoặc deep-research. Hãy chọn tên khác.Failed to create skill
Failed to create skill
Form cho phép gửi khi Description để trống, nhưng thao tác lưu sau đó thất bại với lỗi này. Thêm một câu nói khi nào dùng skill rồi nhấn Create lại. Nếu mô tả đã điền, nghĩa là kho lưu skill không chấp nhận file; hãy thử lại.
Failed to upload skill to executor
Failed to upload skill to executor
Đây là nguyên văn thông báo lỗi (executor là dịch vụ lưu file skill). Thường là do frontmatter của
SKILL.md bị thiếu, không hợp lệ, hoặc thiếu name hay description. Xem khắc phục sự cố định dạng skill.Only .zip files are accepted
Only .zip files are accepted
Thao tác tải lên chỉ chấp nhận
.zip. Hãy đặt SKILL.md (và các thư mục scripts/, schemas/ hoặc references/ nếu có) vào một thư mục, nén thư mục đó thành zip rồi tải lên.No agent can load this skill
No agent can load this skill
Thông báo này hiện dưới dạng cảnh báo trên bảng chi tiết của skill trong More → Workspace settings → Skills. Frontmatter
SKILL.md của skill không có description dùng được, thường do một lần sửa thủ công đã xóa hoặc làm hỏng dòng description:. Sửa thủ công, thêm dòng description: rồi nhấn Save. Trước khi sửa xong, skill không xuất hiện trong menu /.Cannot preview this skill
Cannot preview this skill
Không tải được nội dung file của skill. Nhấn Recovery with AI để dựng lại
SKILL.md cùng CloudThinker qua một cuộc phỏng vấn ngắn, hoặc nhấn Re-upload để khôi phục từ file .zip bạn đã lưu (chẳng hạn file đã tải xuống trước đó).Agent bỏ qua skill
Agent bỏ qua skill
- Kiểm tra công tắc đang bật.
- Kiểm tra đúng khu vực đã được đánh dấu trong Available in (ví dụ Review cho review pull request).
- Viết hướng dẫn cụ thể và thêm ví dụ. Tách một skill dài, quá rộng thành nhiều skill ngắn.
Bước tiếp theo
Định dạng skill
Tổ chức
SKILL.md, đặt frontmatter và viết quy tắc để agent làm theo.Knowledge base
Cung cấp tài liệu tham khảo để agent tra cứu.
Lệnh
Chạy skill và prompt đã lưu từ menu
/.Custom agent
Tạo một agent cho một việc cụ thể và ghép với các skill của bạn.