Học từ skill "production-grade" thật
Các skill docx, xlsx, pptx, pdf mà Anthropic ship chính thức (dùng hằng ngày bởi hàng triệu user trên Claude.ai) là giáo trình sống về cách viết skill công nghiệp. Mở repo anthropics/skills và soi cùng tôi.
Bài học 1: SKILL.md là router, không phải sách giáo khoa
Skill docx KHÔNG nhét toàn bộ kiến thức OOXML vào SKILL.md. Nó phân nhánh theo tác vụ: tạo mới → đọc hướng dẫn A; chỉnh sửa có track changes → đọc hướng dẫn B + dùng script C. Người đọc (AI) chỉ tải đúng nhánh cần.
Bài học 2: Script cho việc máy móc, hướng dẫn cho việc cần phán đoán
Trong skill xlsx: việc đọc/ghi cell dùng script + thư viện (openpyxl) — chính xác tuyệt đối; việc "trình bày bảng sao cho đẹp" là hướng dẫn nguyên tắc — để AI linh hoạt theo ngữ cảnh dữ liệu. Ranh giới script/hướng dẫn được chọn rất có chủ đích.
Bài học 3: Quy ước output rõ ràng
Các skill này luôn quy định: file kết quả đặt tên thế nào, lưu đâu, báo cho user ra sao. Không có vùng mơ hồ "AI tự quyết" ở những điểm chạm với user.
Bài học 4: Phòng thủ lỗi ngay trong tài liệu
Skill pdf có hẳn hướng dẫn xử lý khi: PDF bị scan (cần OCR), PDF có mật khẩu, PDF quá lớn. Người viết đã liệt kê trước các ca hỏng — AI không phải ứng biến.
Bài tập tổng hợp (đồ án mini)
Chọn MỘT quy trình thật trong công việc của bạn và xây skill hoàn chỉnh theo 4 bài học trên:
- SKILL.md dạng router phân nhánh tác vụ
- Ít nhất 1 script cho phần máy móc
- Quy ước output tường minh
- Mục "Xử lý lỗi thường gặp"
Sau đó nhờ Claude chấm điểm skill của bạn theo đúng 4 tiêu chí này. Hoàn thành đồ án = bạn đã ở mức advanced practitioner.