Đóng gói, chia sẻ và dùng Skill trong nhóm QA

1. Bật điều kiện cần trước khi dùng Skill

Trước khi upload bất kỳ Skill nào, cần bật tính năng nền tảng. Vào Settings > Capabilities và đảm bảo Code execution and file creation đã được bật. Skill cần môi trường thực thi an toàn này để hoạt động; nếu chưa bật, Skill sẽ không chạy.

Trên gói Team/Enterprise, quản trị viên cần bật cả Code execution and file creation lẫn Skills trong Organization settings > Skills trước khi thành viên dùng được.

2. Đóng gói Skill thành file ZIP

Quy trình đóng gói cho người dùng cá nhân:

1. Hoàn thiện thư mục Skill theo đúng cấu trúc (đã trình bày ở Bài 3 và Bài 6).
2. Nén cả thư mục thành file .zip.
3. Đảm bảo SKILL.md nằm đúng trong thư mục được nén, không bị lệch cấp.

Lưu ý cấu trúc: Khi nén, hãy nén chính thư mục Skill (ví dụ sinh-test-case-tu-user-story/), sao cho giải nén ra thấy ngay thư mục đó chứa SKILL.md. Nếu nén sai cấp, hệ thống có thể báo lỗi không tìm thấy SKILL.md.

3. Upload vào Claude (web hoặc desktop)

Các bước upload Skill cá nhân:

1. Vào Customize > Skills.
2. Nhấn nút "+", rồi chọn "+ Create skill".
3. Tải lên file ZIP chứa thư mục Skill.
4. Skill sẽ xuất hiện trong danh sách và có thể bật/tắt.

Skill cá nhân tải lên là riêng tư với tài khoản của bạn. Để chia sẻ với nhóm, xem mục 5 bên dưới.

4. Dùng Skill trong Claude Code

Với Claude Code, Skill là thư mục chứa SKILL.md đặt tại:

Skill phạm vi dự án (.claude/skills/) đặc biệt hữu ích cho nhóm QA: khi commit vào repo, mọi thành viên clone về đều có sẵn Skill mà không cần cài thủ công. Có thể liệt kê Skill đã cài bằng lệnh claude --list-skills hoặc gõ /skills trong phiên làm việc.

5. Chia sẻ Skill trong nhóm QA

5a. Trên gói Team / Enterprise

Có thể chia sẻ Skill đã tạo với từng đồng nghiệp cụ thể hoặc toàn tổ chức. Trên các gói này, quản trị viên/chủ sở hữu còn có thể provision Skill cho toàn tổ chức — các Skill này tự động xuất hiện cho mọi thành viên. Tính năng triển khai Skill cấp tổ chức đi kèm cập nhật tự động và quản lý tập trung.

5b. Qua GitHub (cho mọi gói)

Cách phổ biến để lưu trữ và chia sẻ Skill mã nguồn mở:

1. Lưu trên GitHub: tạo repo công khai, kèm README rõ ràng và ví dụ sử dụng.
2. Hướng dẫn cài đặt: ghi rõ các bước tải về, nén và upload.
3. Ví dụ minh họa: đính kèm ảnh chụp màn hình kết quả để người dùng hình dung.

Lưu ý về README: README ở cấp repo là dành cho người đọc trên GitHub — đây là file riêng, không đặt bên trong thư mục Skill. Bên trong thư mục Skill vẫn tuân thủ quy tắc không có README.md (xem lại Bài 3).

6. Cập nhật Skill — coi như tài liệu sống

Skill nên được cập nhật khi quy trình của nhóm thay đổi:

• Chỉnh sửa nội dung Skill, đóng gói lại.
• Vào Customize > Skills, tải lên phiên bản mới, vô hiệu hóa hoặc xóa bản cũ nếu cần.
• Cập nhật trường version trong metadata để theo dõi phiên bản.

Một lưu ý quan trọng: nếu sau khi sửa mà Skill ngừng kích hoạt, hãy kiểm tra trường description đầu tiên — đây là nơi quyết định khi nào Skill được dùng (xem lại Bài 4 và Bài 7).

7. Gợi ý áp dụng cho nhóm QA tại IT Learn

Một số hướng triển khai Skill trong môi trường kiểm thử thực tế:

• Đặt các Skill dùng chung (sinh test case, chuẩn hóa bug report, export TestRail) vào .claude/skills/ của repo kiểm thử để cả nhóm dùng đồng bộ.
• Quy ước đặt tên và cấu trúc thống nhất giữa các Skill, giúp bảo trì dễ hơn.
• Định kỳ rà soát và cập nhật Skill khi quy trình kiểm thử thay đổi.

8. Tổng kết bài 8 và toàn chuỗi

• Trước khi dùng Skill, cần bật Code execution and file creation; gói tổ chức cần quản trị viên bật thêm Skills.
• Đóng gói đúng cấu trúc thành ZIP, upload qua Customize > Skills; Skill cá nhân là riêng tư.
• Với Claude Code, đặt Skill vào .claude/skills/ của repo để chia sẻ trong nhóm khi clone.
• Gói Team/Enterprise hỗ trợ chia sẻ và provision cấp tổ chức; GitHub là kênh lưu trữ phổ biến cho mọi gói.
• Skill là tài liệu sống — cập nhật theo quy trình, và luôn kiểm tra description nếu Skill ngừng kích hoạt.

Hết chuỗi 8 bài. Từ khái niệm Skill (Bài 1), chuẩn bị môi trường (Bài 2), cấu trúc (Bài 3), YAML (Bài 4), Instructions (Bài 5), dựng Skill thực tế (Bài 6), kiểm thử (Bài 7) đến chia sẻ trong nhóm (Bài 8) — người đọc đã có đủ nền tảng để xây dựng và vận hành Skill phục vụ công việc kiểm thử.