Một dòng quyết định skill sống hay chết
Nhắc lại từ bài Progressive Disclosure: Claude quyết định dùng skill chỉ dựa trên description. Skill viết hay đến đâu mà description tệ thì không bao giờ được kích hoạt.
3 lỗi phổ biến
1. Mô tả quá ngắn, thiếu ngữ cảnh dùng
❌ description: Hỗ trợ viết báo cáo
Claude không biết "báo cáo" nghĩa là gì với bạn, khi nào nên dùng.
2. Chỉ nói skill LÀ GÌ mà không nói KHI NÀO DÙNG
❌ description: Bộ quy chuẩn thiết kế của công ty ABC
✅ description: Bộ quy chuẩn thiết kế (màu, font, logo) của công ty ABC. Dùng khi user tạo slide, banner, landing page hoặc bất kỳ tài liệu nào mang thương hiệu ABC.
3. Trùng lắp trigger giữa các skill
Hai skill cùng nói "dùng khi viết email" → Claude phân vân hoặc chọn sai. Mỗi skill cần lãnh thổ trigger riêng: "email chăm sóc khách hàng" vs "email báo cáo nội bộ".
Công thức description chuẩn
[Động từ + đối tượng cụ thể] + [theo chuẩn/quy trình gì] + "Dùng khi user" + [liệt kê 3-5 cách yêu cầu thực tế]
Kỹ thuật "từ khóa người thật"
Liệt kê những từ user THẬT SỰ gõ, kể cả tiếng Việt không dấu hay từ lóng: "Dùng khi user nói: review PR, check code, xem code, soát lỗi code". Description khớp ngôn ngữ tự nhiên của người dùng = tỉ lệ kích hoạt cao.
Bài tập
Lấy 3 skill bạn đã viết, đưa description cho Claude và hỏi: "Với mô tả này, liệt kê 10 câu yêu cầu sẽ kích hoạt skill và 5 câu dễ kích hoạt NHẦM." — Đây là cách rẻ nhất để stress-test trigger trước khi dùng thật.