Cẩm Nang Tài Nguyên Và Quy Chuẩn Phát Triển Skill

Chương 6 của tài liệu có tiêu đề "Resources and references" (Tài nguyên và tài liệu tham khảo), đóng vai trò là một kho tàng tổng hợp các công cụ, đường dẫn và phụ lục hỗ trợ người dùng trong quá trình xây dựng skill. Dưới đây là nội dung chi tiết của chương này:

1. Tổng hợp tài nguyên hỗ trợ và tài liệu chính thức

• Tài liệu và Hướng dẫn (Official Documentation): Cung cấp các đường dẫn đến tài liệu chính thức của Anthropic như Hướng dẫn thực hành tốt nhất (Best Practices Guide), tài liệu API, tài liệu MCP và các bài đăng trên blog kỹ thuật.

• Công cụ tiện ích (Tools and Utilities): Khuyến nghị sử dụng công cụ skill-creator (có sẵn trên Claude.ai và Claude Code) để tự động tạo skill từ mô tả, nhận các đánh giá đề xuất và hỗ trợ kiểm tra (validation).

• Kênh hỗ trợ (Getting Support): Hướng dẫn người dùng nơi đặt câu hỏi kỹ thuật (qua diễn đàn cộng đồng trên Discord) hoặc nơi báo cáo lỗi (qua GitHub Issues của kho lưu trữ anthropics/skills).

2. Ba phụ lục (References) cực kỳ quan trọng Chương 6 cung cấp 3 bộ tài liệu tham chiếu (Reference A, B, C) giúp chuẩn hóa toàn bộ quá trình phát triển skill:

• Phụ lục A - Danh sách kiểm tra nhanh (Quick checklist): Đây là danh sách các hạng mục bạn cần tick chọn để đảm bảo skill không gặp lỗi, chia thành 4 giai đoạn:

  • Trước khi bắt đầu: Đã xác định rõ 2-3 trường hợp sử dụng cụ thể, lên kế hoạch cấu trúc thư mục.

  • Trong quá trình phát triển: Đảm bảo tên thư mục viết theo định dạng kebab-case, tên tệp là SKILL.md (chính xác từng chữ hoa/thường), frontmatter không chứa thẻ XML (< >), các lỗi đã được dự trù và hướng dẫn rõ ràng.

  • Trước khi tải lên: Đã kiểm thử chức năng, kiểm tra các câu lệnh kích hoạt và nén thành tệp .zip.

  • Sau khi tải lên: Theo dõi mức độ kích hoạt (quá ít/quá nhiều) trong thực tế để cập nhật và điều chỉnh phiên bản.

• Phụ lục B - Cấu trúc chi tiết của YAML frontmatter: Tổng hợp đầy đủ cách viết cấu hình cho skill:

  • Trường bắt buộc: name (tên skill) và description (mô tả cách dùng và khi nào dùng).

  • Trường tùy chọn: Khai báo giấy phép (license), giới hạn quyền truy cập công cụ (allowed-tools), và siêu dữ liệu (metadata chứa tên tác giả, phiên bản, tên máy chủ MCP...).

  • Lưu ý bảo mật (Security notes): Được phép dùng các định dạng YAML chuẩn, nhưng tuyệt đối cấm dùng thẻ mở/đóng XML (< >), cấm thực thi mã code ngay trong file YAML, và cấm dùng từ khóa "claude" hay "anthropic" để đặt tên skill.

• Phụ lục C - Kho ví dụ mẫu hoàn chỉnh (Complete skill examples): Thay vì phải bắt đầu từ con số 0, chương này cung cấp link đến các kho lưu trữ (như GitHub anthropics/skills) chứa các mẫu skill chuẩn để bạn có thể sao chép (clone) và chỉnh sửa. Các mẫu này bao gồm:

  • Skill tạo tài liệu (PDF, DOCX, PPTX, XLSX).

  • Các skill ví dụ về các mô hình thiết kế workflow (như đã nói ở Chương 5).

  • Danh bạ skill của các đối tác lớn như Asana, Atlassian, Canva, Figma, Sentry, Zapier....