Checklist chuẩn hoá
4 mốc kiểm tra

✓ Description

Cụ thể, có từ khoá thực tế người dùng gõ. Nói cả skill làm gì và khi nào dùng. Viết ngôi thứ ba.

✓ Độ dài

Thân SKILL.md dưới 500 dòng. Chi tiết bổ sung đã tách ra file riêng.

✓ Thời gian tính

Không có thông tin gắn mốc ngày tháng, hoặc đã gói trong mục "Pattern cũ".

✓ Thuật ngữ

Nhất quán xuyên suốt. Không trộn nhiều từ cho cùng một khái niệm.

✓ Ví dụ

Cụ thể, không trừu tượng. Có cặp đầu vào và đầu ra nếu chất lượng phụ thuộc định dạng.

✓ Tham chiếu

Mọi file link trực tiếp từ SKILL.md, chỉ một tầng. File dài trên 100 dòng có mục lục.

✓ Quy trình

Các bước rõ ràng, có checklist để Claude tự đánh dấu tiến độ nếu quy trình dài.

✓ Tiết lộ lũy tiến

Đã dùng đúng cách — nội dung hiếm dùng nằm ở file riêng, không nhét hết vào file chính.

□ Script tự giải quyết vấn đề thay vì đùn đẩy cho Claude
□ Xử lý lỗi tường minh và có thông báo hữu ích
□ Không có hằng số bí ẩn — mọi giá trị đều được giải thích
□ Đã liệt kê package cần thiết và xác nhận có sẵn trong môi trường
□ Không dùng đường dẫn kiểu Windows — toàn bộ dấu gạch chéo xuôi
□ Có bước validation cho các thao tác quan trọng

□ Đã tạo tối thiểu 3 kịch bản đánh giá
□ Đã test với Haiku, Sonnet và Opus — mọi model bạn định dùng
□ Đã test với kịch bản sử dụng thật, không chỉ ví dụ mẫu
□ Đã thu thập phản hồi từ đồng nghiệp nếu skill dùng chung
□ Đã đo tỷ lệ trigger và so với baseline không có skill