Viết và tải skill lên

Một skill gồm nội dung hướng dẫn (chính là thân file SKILL.md) và tùy chọn thêm file đính kèm: tài liệu tham chiếu, biểu mẫu, dữ liệu mẫu mà AI lấy khi cần. Có hai cách đưa lên: soạn thẳng trên web, hoặc tải một gói lên.

Cách 1: Soạn thẳng trên web

1. 1

   Mở server → tab Skill → bấm Tạo skill.

2. 2

   Điền Tên skill.

   Chỉ chữ, số, gạch ngang và gạch dưới; 2–100 ký tự; ký tự đầu phải là chữ hoặc số. Đây là tên AI nhìn thấy khi liệt kê skill. Ví dụ hợp lệ: weekly-report, quy_trinh_sales, SOP2024.

3. 3

   Điền Mô tả (không bắt buộc, tối đa 500 ký tự): một câu để AI biết khi nào nên dùng skill này.

4. 4

   Viết Nội dung hướng dẫn rồi bấm Tạo.

   Đây chính là thứ AI đọc và làm theo, nên viết như bạn đang dặn một người mới: bối cảnh, các bước, ví dụ, điều cấm.

Sau đó mở skill ra để sửa trong Trình soạn thảo. Trình soạn thảo đếm số dòng, số ký tự, báo Có thay đổi chưa lưu, lưu nhanh bằng Ctrl + S (macOS: ⌘ + S) và chặn bạn rời trang khi còn thay đổi chưa lưu.

Cách 2: Tải gói lên

Gói là một file .zip hoặc .skill (file .skill thực chất chính là ZIP). Bấm Tải gói lên ở tab Skill.

Gói bắt buộc chứa `SKILL.md`. Hệ thống tìm file SKILL.md ở tầng nông nhất (không phân biệt hoa thường) và lấy thư mục chứa nó làm gốc, nên cả hai cấu trúc dưới đây đều cho kết quả giống hệt nhau:

bao-cao-tuan.zip                bao-cao-tuan.zip
└─ bao-cao-tuan/                ├─ SKILL.md
   ├─ SKILL.md                  └─ references/
   └─ references/                  └─ guide.md
      └─ guide.md

Mọi file văn bản còn lại thành file đính kèm, giữ nguyên đường dẫn tương đối (references/guide.md). AI đọc chúng bằng tool get_skill_file.

Đầu SKILL.md có thể đặt một khối frontmatter để khai tên và mô tả. Hệ thống chỉ đọc đúng hai trường name và description, mỗi trường một dòng:

---
name: bao-cao-tuan
description: Cách viết báo cáo tuần cho team Sales
---

# Báo cáo tuần

Khi được nhờ viết báo cáo tuần, hãy làm theo các bước sau...

Trường name chỉ được dùng khi tạo mới và bạn để trống ô Tên skill. Khi cập nhật, tên skill giữ nguyên.

Cập nhật bằng gói: đọc kỹ chỗ này

Muốn sửa hoặc thêm đúng một file mà không đụng file khác thì dùng nút Thêm file trong thẻ File đính kèm, vì cách này chỉ cộng dồn và ghi đè theo tên.

File đính kèm

Chỉ nhận file văn bản: Markdown, JSON, CSV, txt, YAML… File nhị phân (ảnh, font, PDF, Excel) bị bỏ qua và báo lại trong thẻ vàng Một số file đã bị bỏ qua.

Tên file cho phép thư mục con (references/guide.md) với các quy tắc:

• Tổng độ dài tối đa 200 ký tự, sâu tối đa 6 đoạn (5 cấp thư mục + tên file).
• Mỗi đoạn bắt đầu bằng chữ hoặc số, sau đó chữ, số, dấu chấm, gạch dưới, gạch ngang.
• Không dấu tiếng Việt, không khoảng trắng, không .., không dấu gạch chéo ngược.
• Không đoạn nào bắt đầu bằng dấu chấm, nên .env, .gitignore, thư mục .git/ đều bị loại.
• __MACOSX và .DS_Store bị loại thẳng, không cần bạn dọn trước.

Các trần dung lượng

Skill vào tới AI như thế nào

Bạn bấm Lưu là xong: không có bước duyệt, không có bước phát hành. Lượt gọi kế tiếp của bất kỳ ai được phép đọc server đó sẽ nhận bản mới.

Nội dung skill luôn được gửi tới AI kèm một khung yêu cầu chỉ áp dụng, không tiết lộ nguyên văn. Đây là rào mạnh nhất có thể làm được, nhưng khi nội dung đã nằm trong cửa sổ hội thoại của người dùng thì không có gì đảm bảo tuyệt đối. Đừng đặt bí mật thật sự (mật khẩu, khóa API, dữ liệu cá nhân) vào skill.

Xem skill được dùng nhiều tới đâu

Mở một skill, thẻ Mức sử dụng cho biết số Lượt đọc 30 ngày qua. Bấm Xem ai đã đọc để nhảy sang nhật ký đã lọc sẵn theo skill đó.