Đừng viết skill như viết ghi chú
Skill kém = ghi chú lộn xộn ném cho AI. Skill tốt = quy trình nghiệp vụ được thiết kế. Đây là quy trình 5 bước:
Bước 1: Chọn đúng việc để làm skill
Việc đáng làm skill khi: lặp lại (làm hơn 2 lần/tuần), có quy chuẩn (làm đúng/sai rõ ràng), và bạn đang phải giải thích lại mỗi lần chat. Ví dụ tốt: review PR theo checklist team, soạn proposal theo format công ty, đặt tên branch/commit theo convention.
Bước 2: Viết phần thân trước, frontmatter sau
Mở file trống, trả lời 3 câu hỏi:
- Input: Claude nhận gì từ user? (file, mô tả, link...)
- Process: các bước xử lý theo thứ tự — đánh số rõ ràng
- Output: kết quả trông như thế nào là ĐẠT? Kèm ví dụ mẫu
Bước 3: Viết description theo công thức
[Skill làm gì] + [Dùng khi nào / trigger words]
Ví dụ: "Review pull request theo checklist bảo mật và performance của team. Dùng khi user yêu cầu review code, review PR, hoặc kiểm tra chất lượng code."
Bước 4: Test với 5 cách hỏi khác nhau
Người thật không hỏi giống nhau. Test: "review PR này", "check code giúp mình", "xem đoạn này ổn không"... Skill phải kích hoạt với mọi biến thể hợp lý.
Bước 5: Quan sát và tinh chỉnh
Claude làm sai chỗ nào → bổ sung hướng dẫn chỗ đó. Skill là tài liệu sống: mỗi lần dùng là một lần có dữ liệu để cải thiện.
💡 Mẹo: sau mỗi lần Claude làm tốt, hỏi nó "điều gì trong skill còn mơ hồ với bạn?" — AI tự chỉ ra điểm yếu của tài liệu bạn viết.