Claude Skills là gì? Hướng dẫn tạo skill đầu tiên cho Claude Code

Skill là gì

Một skill là một thư mục có file SKILL.md bên trong. File này gồm hai phần:

• Phần đầu (frontmatter): tên và mô tả. Claude đọc phần mô tả để biết khi nào nên dùng skill.
• Phần nội dung: hướng dẫn chi tiết Claude làm theo khi skill được dùng.

Ví dụ cách dùng: quy trình viết bài đúng giọng văn của shop, cách kiểm tra code trước khi đưa lên, mẫu báo cáo hằng tuần.

Bước 1: chọn nơi đặt skill

Nơi đặt	Đường dẫn	Dùng được ở đâu
Cá nhân	~/.claude/skills/<ten-skill>/SKILL.md	Mọi dự án trên máy bạn
Theo dự án	.claude/skills/<ten-skill>/SKILL.md	Chỉ dự án đó, chia sẻ được cho cả nhóm qua git

Bước 2: viết file SKILL.md

---
name: tom-tat-thay-doi
description: Tóm tắt các thay đổi chưa commit và chỉ ra rủi ro. Dùng khi người dùng hỏi mình đã sửa gì.
---

## Việc cần làm
1. Tóm tắt thay đổi trong 2 đến 3 gạch đầu dòng.
2. Liệt kê rủi ro: thiếu xử lý lỗi, giá trị gõ cứng, phần chưa kiểm thử.
3. Không có thay đổi nào thì nói rõ là không có.

Ba quy tắc quan trọng:

• Dòng --- mở đầu phải là dòng đầu tiên của file, nếu không Claude Code coi cả file là nội dung thường.
• Tên chỉ gồm chữ thường, số và dấu gạch ngang, tối đa 64 ký tự.
• Mô tả nói rõ hai điều: skill làm gì, và khi nào nên dùng. Đây là thứ quyết định Claude có tự gọi skill hay không.

Bước 3: gọi skill

• Tự động: hỏi một câu khớp với mô tả, ví dụ "Mình đã sửa những gì?". Claude tự nhận ra và dùng skill.
• Gọi tay: gõ /tom-tat-thay-doi ở đầu tin nhắn.

Mẹo viết skill tốt

• Giữ SKILL.md dưới 500 dòng. Tài liệu dài thì tách ra file riêng như reference.md trong cùng thư mục, rồi nhắc tới nó trong SKILL.md. Claude chỉ đọc file đó khi cần.
• Viết như quy tắc làm việc lâu dài, không phải một lần. Nội dung skill nằm lại suốt phiên làm việc sau khi được gọi.
• Không muốn Claude tự gọi (ví dụ skill triển khai web)? Thêm dòng disable-model-invocation: true vào phần đầu, khi đó chỉ bạn gọi tay được.

Thử ngay

Chọn một việc bạn lặp lại mỗi tuần, viết các bước ra thành SKILL.md, đặt vào ~/.claude/skills/. Lần sau chỉ cần nói một câu, Claude làm đúng quy trình của bạn.