Công cụ AI
Viết mô tả cho Claude Skill sao cho Claude tự gọi đúng lúc
Bạn viết skill rất kỹ, nhưng Claude không bao giờ tự dùng nó? Lỗi thường nằm ở hai dòng mô tả. Claude chỉ đọc phần mô tả để quyết định có dùng skill hay không, nội dung bên trong chỉ được đọc sau đó. Đây là cách viết cho đúng.
Claude quyết định thế nào
Mỗi lượt trò chuyện, Claude chỉ nạp phần mô tả của từng skill. Khi yêu cầu của bạn khớp với mô tả, Claude mới mở nội dung đầy đủ của skill ra đọc. Nghĩa là: mô tả mơ hồ thì skill hay mấy cũng không được dùng.
Nếu chưa biết tạo skill, đọc trước bài Claude Skills là gì.
Công thức hai vế
Một mô tả tốt luôn trả lời đủ hai câu:
- Skill làm gì?
- Khi nào nên dùng? Ghi rõ những tình huống, những cụm từ người dùng hay nói.
Ví dụ dở và tốt
| Mô tả | |
|---|---|
| Dở | Hỗ trợ viết bài. |
| Tốt | Viết bài blog đúng giọng văn của shop: câu ngắn, gọi khách là "bạn", không từ sáo rỗng. Dùng khi người dùng nhờ viết bài, viết caption, hoặc sửa giọng văn. |
| Dở | Kiểm tra code. |
| Tốt | Rà soát thay đổi chưa commit, chỉ ra lỗi bảo mật và phần chưa kiểm thử. Dùng khi người dùng hỏi "mình đã sửa gì", "kiểm tra giúp trước khi push". |
Bản tốt cụ thể về việc làm, và liệt kê đúng những câu người dùng hay nói.
Năm mẹo nhỏ
- Ý quan trọng lên đầu. Mô tả quá dài sẽ bị cắt trong danh sách skill.
- Dùng từ của người dùng, không dùng từ kỹ thuật chỉ mình bạn hiểu.
- Mỗi skill một việc. Một skill ôm nhiều việc thì mô tả khó viết rõ, Claude khó chọn đúng.
- Thêm trường
when_to_usekhi muốn ghi riêng các tình huống kích hoạt. Nội dung này được nối vào sau mô tả. - Skill có rủi ro (triển khai, xoá dữ liệu) thì đặt
disable-model-invocation: true, chỉ gọi tay.
Thử xem đã khớp chưa
Mở phiên mới, gõ đúng câu bạn thường nói khi cần việc đó. Claude dùng skill là mô tả đã ổn. Không dùng thì thêm vào mô tả chính câu bạn vừa gõ, rồi thử lại.
Câu hỏi thường gặp
Mô tả nên dài bao nhiêu?
Một đến ba câu là đủ. Phần mô tả bị cắt nếu quá dài trong danh sách skill, nên đặt ý quan trọng nhất lên đầu.
Có cách nào chặn Claude tự gọi skill không?
Có. Thêm dòng disable-model-invocation: true vào phần đầu SKILL.md, khi đó chỉ bạn gọi được bằng dấu / và tên skill.
Viết mô tả bằng tiếng Việt được không?
Được. Nên dùng đúng những từ bạn hay gõ khi nhờ Claude làm việc đó, để yêu cầu dễ khớp với mô tả.


