Xây Skill Đầu Tiên Cho Claude Code: Từ Số 0 Đến Chạy Được

Lần đầu nghe "viết Skill cho Claude Code", mình tưởng phải biết lập trình mới làm được. Hoá ra không. Một Skill về bản chất chỉ là một file văn bản mô tả rõ ràng: khi nào Claude nên dùng, và làm theo quy trình nào. Không cần biên dịch, không cần deploy.

Skill là gì và khi nào cần

Skill là một gói hướng dẫn có cấu trúc, gồm ít nhất một file SKILL.md, đặt trong thư mục riêng để Claude Code tự nạp khi phát hiện yêu cầu khớp với mô tả trong file đó. Khác với việc gõ lại quy trình vào mỗi lần chat, Skill lưu quy trình một lần và Claude tự gọi lại đúng lúc.

📌 Chưa chắc nên chọn gì? Đọc trước Học AI: Dùng Claude, ChatGPT, Gemini Đúng Việc — hướng dẫn tổng hợp của Kudomax về học ai.

Nên viết Skill khi bạn thấy mình lặp lại cùng một hướng dẫn dài từ 3 lần trở lên: quy trình review code theo chuẩn riêng của team, cách viết báo cáo theo mẫu công ty, hay quy trình deploy có nhiều bước cố định.

5 bước dựng một Skill

• 1. Tạo thư mục riêng trong .claude/skills/ten-skill/, đặt tên bằng chữ thường và dấu gạch ngang, không dấu tiếng Việt.
• 2. Viết phần frontmatter ở đầu SKILL.md: name (trùng tên thư mục) và description mô tả rõ skill làm gì và khi nào nên dùng, đây là phần Claude đọc để quyết định có gọi skill hay không, viết mơ hồ là skill sẽ không bao giờ được gọi tới.
• 3. Viết quy trình bên dưới frontmatter bằng Markdown thường, giống hướng dẫn viết cho một người mới vào việc: mục tiêu, các bước theo thứ tự, ví dụ đầu ra mong muốn.
• 4. Test bằng chính câu hỏi thật mà bạn nghĩ sẽ trigger skill, xem Claude có tự gọi đúng skill không.
• 5. Sửa lại description nếu skill không được gọi hoặc bị gọi nhầm lúc không cần. 90% lỗi Skill không chạy nằm ở bước này, chứ không phải ở nội dung quy trình.

Lỗi hay gặp nhất: description quá chung chung

Viết "Giúp viết code tốt hơn" thì gần như không bao giờ được gọi, vì quá rộng để Claude quyết định đây có phải đúng lúc không. Viết cụ thể: "Dùng khi user yêu cầu review pull request theo chuẩn TypeScript strict mode của team, kiểm tra type an toàn và test coverage". Càng cụ thể, tỷ lệ gọi đúng lúc càng cao.

Xem thêm 60+ slash command hữu ích cho Claude Code nếu bạn muốn kết hợp Skill với lệnh tuỳ biến cho quy trình lặp lại thường xuyên hơn.