Skill là gì? Cách tạo và dùng Skill để AI làm đúng việc, đúng quy trình

Bạn có một đoạn hướng dẫn mà tuần nào cũng dán lại cho AI: "viết báo cáo theo mẫu này", "review code theo checklist kia", "đặt tên file theo quy tắc công ty". Mỗi lần dán là một lần tốn công, và AI vẫn có thể làm lệch ở đâu đó.

Skill sinh ra để giải đúng chỗ này: biến đoạn hướng dẫn lặp lại thành một gói có tên, lưu một lần, AI tự lấy ra dùng khi gặp đúng việc.

Skill là gì

Skill (tên đầy đủ là Agent Skill) là một thư mục chứa hướng dẫn cho Claude làm một loại việc cụ thể. Trung tâm của thư mục là file SKILL.md. Ngoài ra có thể kèm script, file mẫu, tài liệu tham khảo.

Một skill gồm hai phần trong SKILL.md:

• Frontmatter (YAML, nằm giữa hai dòng ---): khai báo name và description.
• Nội dung: các bước Claude cần làm, quy tắc, ví dụ.

Ví dụ skill nhỏ nhất có thể chạy:

---
name: summarize-changes
description: Tóm tắt các thay đổi code chưa commit và chỉ ra rủi ro. Dùng khi người dùng hỏi "tôi vừa sửa gì" hoặc trước khi commit.
---

## Thay đổi hiện tại

!`git diff HEAD`

## Cách làm

1. Tóm tắt thay đổi trong 3-5 gạch đầu dòng.
2. Nêu rủi ro: file nhạy cảm, thay đổi lớn, thiếu test.
3. Đề xuất một câu commit message.

Chỉ cần vậy là Claude đã có một "quy trình" để gọi lại bất cứ lúc nào.

Skill khác gì prompt, khác gì MCP

	Prompt	Skill	MCP
Là gì	Câu lệnh bạn gõ mỗi lần	Gói hướng dẫn lưu sẵn, Claude tự nạp khi cần	Cổng kết nối AI với công cụ/dữ liệu bên ngoài
Dùng khi	Việc làm một lần	Việc lặp lại cần làm đúng một cách	Cần AI đọc/ghi hệ thống khác (lịch, CRM, database)
Nằm ở	Trong cuộc chat	Thư mục file trên máy hoặc tài khoản	Một server kết nối

Cách nhớ: prompt là lời dặn, skill là sổ tay quy trình, MCP là đôi tay chạm vào hệ thống khác. Ba thứ này bổ trợ nhau chứ không thay thế nhau.

Claude dùng skill như thế nào

Điểm hay của skill là không nhồi hết mọi thứ vào ngữ cảnh ngay từ đầu. Theo tài liệu chính thức của Anthropic, skill được nạp theo ba tầng (cơ chế "tiết lộ dần", progressive disclosure):

1. Metadata (name và description): luôn được nạp, để Claude biết có những skill nào.
2. Hướng dẫn trong SKILL.md: chỉ nạp khi yêu cầu của bạn khớp với skill.
3. File tham chiếu và script: chỉ nạp hoặc chạy khi thật sự cần. Script được chạy qua bash và Claude chỉ nhận kết quả đầu ra, nên ổn định và tiết kiệm token.

Hệ quả thực tế: bạn có thể cài nhiều skill mà không làm "phình" mỗi cuộc chat. Và vì Claude quyết định có dùng skill hay không dựa trên description, description là phần quan trọng nhất của skill.

Cách viết một skill tốt

1. Description nêu cả "làm gì" lẫn "khi nào dùng".
Claude so yêu cầu của bạn với description để chọn skill. Viết mơ hồ thì skill không bao giờ được gọi.

• Yếu: Hỗ trợ báo cáo.
• Tốt: Tạo báo cáo doanh số tuần từ file Excel theo mẫu công ty. Dùng khi người dùng yêu cầu báo cáo tuần, tổng hợp doanh số hoặc gửi số liệu cho giám đốc.

2. Tuân thủ quy tắc của frontmatter.
Theo tài liệu Agent Skills: name tối đa 64 ký tự, chỉ gồm chữ thường, số và dấu gạch nối; description không được rỗng và tối đa 1024 ký tự.

3. Bắt đầu từ việc bạn đang lặp lại.
Khi bạn thấy mình dán cùng một hướng dẫn lần thứ ba, đó là lúc đóng gói thành skill. Đừng viết skill cho việc bạn chưa từng làm.

4. Viết như hướng dẫn cho người mới vào nghề.
Các bước rõ ràng, đánh số, kèm ví dụ đầu vào và đầu ra. Việc nào cần kết quả cố định (tính toán, định dạng file) thì đưa vào script thay vì mô tả bằng lời.

5. Thử trên dữ liệu thật.
Anthropic khuyên kiểm thử kỹ trong môi trường của bạn trước khi giao việc quan trọng.

Dùng skill trong Claude Code

Claude Code (công cụ lập trình AI chạy trên terminal của Anthropic) là nơi dùng skill linh hoạt nhất.

Bước 1: tạo thư mục skill

Skill cá nhân (dùng ở mọi dự án):

mkdir -p ~/.claude/skills/summarize-changes

Skill dự án (chỉ trong repo này, commit được để cả nhóm dùng chung) nằm ở .claude/skills/ trong repo.

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

Tạo file SKILL.md trong thư mục vừa tạo, với description rõ ràng như ví dụ ở trên. Cú pháp !`lệnh` chạy lệnh shell và chèn kết quả (ví dụ git diff HEAD) vào nội dung skill trước khi Claude đọc.

Bước 3: gọi skill

Có hai cách:

• Tự động: hỏi tự nhiên, ví dụ "tôi vừa thay đổi gì?". Nếu khớp description, Claude tự dùng skill.
• Thủ công: gõ /summarize-changes (có thể kèm tham số). Lưu ý: chỉ tên skill đặt ở đầu tin nhắn mới chạy trực tiếp; nhắc tên giữa câu chỉ cho phép Claude cân nhắc dùng.

Skill đến từ plugin được gọi dạng /tên-plugin:tên-skill.

Bước 4: quản lý

• Sửa nội dung trong thư mục skill được nhận ngay trong phiên. Nếu bạn tạo thư mục skills cấp cao mới sau khi khởi động, chạy /reload-skills.
• Dùng /skill-doctor để xem mỗi skill tốn bao nhiêu ngữ cảnh và được dùng ra sao.
• Claude Code có sẵn một số skill như /code-review, /debug, /loop, /claude-api.

Khoá skill nhạy cảm

Với việc có tác động lớn như deploy, đặt trong frontmatter:

disable-model-invocation: true

Khi đó chỉ bạn gõ /deploy mới chạy, Claude không tự ý gọi. Ngược lại, user-invocable: false ẩn skill khỏi menu và chỉ để Claude dùng.

Còn custom slash command cũ?

Custom command đã được gộp vào skill. File trong .claude/commands/ vẫn chạy, nhưng việc mới nên viết thành skill; nếu trùng tên thì skill được ưu tiên.

Cài skill có sẵn của Anthropic

Anthropic công bố kho anthropics/skills trên GitHub, gồm skill mẫu (sáng tạo và thiết kế, kỹ thuật, giao tiếp doanh nghiệp, tài liệu văn phòng), thư mục spec mô tả chuẩn và thư mục template để bắt đầu viết skill riêng.

Trong Claude Code, đăng ký kho làm marketplace rồi cài:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Gói document-skills xử lý Word, PDF, PowerPoint, Excel. Lưu ý: theo tài liệu Agent Skills, các skill tài liệu dựng sẵn không có sẵn trong Claude Code, nên cần cài qua plugin như trên. Nhóm skill docx, pdf, pptx, xlsx chỉ công khai mã nguồn để tham khảo, không phải mã nguồn mở; nhiều skill khác dùng Apache 2.0.

Dùng skill trên Claude.ai và API

Skill có ở ba nơi, mỗi nơi một cách chia sẻ riêng:

Nền tảng	Cách đưa skill vào	Phạm vi
Claude Code	Đặt thư mục trong ~/.claude/skills/ hoặc .claude/skills/	Theo người dùng hoặc theo dự án
Claude.ai	Tải file zip lên ở Settings → Features	Chỉ dùng cá nhân
Claude API	Tải lên qua các endpoint /v1/skills	Dùng chung toàn workspace

Một vài điểm cần biết, theo tài liệu chính thức:

• Skill tuỳ chỉnh trên Claude.ai có ở gói Pro, Max, Team và Enterprise, khi bật code execution.
• Skill không tự đồng bộ giữa các nền tảng. Skill tải lên Claude.ai không có trên API và ngược lại; Claude Code dùng thư mục riêng. Bạn phải quản lý từng nơi.
• Trên Claude API, skill chạy trong sandbox không có Internet và không cài thêm gói lúc chạy. Nếu cần dữ liệu ngoài, hãy đưa sẵn dữ liệu vào yêu cầu.
• Agent Skills không nằm trong thỏa thuận Zero Data Retention và được lưu theo chính sách tiêu chuẩn.

Ví dụ thực tế cho doanh nghiệp nhỏ

Agency web 5 người. Trưởng nhóm hay thấy thành viên quên bước kiểm tra trước khi bàn giao. Anh tạo skill dự án trong .claude/skills/ với checklist: chạy test, kiểm tra biến môi trường, rà soát giao diện mobile. Skill deploy được đặt disable-model-invocation: true. Thư mục skill được commit vào repo, nên người mới clone về là dùng ngay cùng một quy trình.

Văn phòng kế toán. Mỗi tuần nhận hàng chục hồ sơ PDF. Người phụ trách IT cài document-skills, yêu cầu Claude dùng skill PDF đọc các trường biểu mẫu rồi tổng hợp vào Excel bằng skill xlsx. Song song, nhóm viết thêm một skill riêng mô tả quy tắc đặt tên file và kiểm tra số liệu theo quy trình của công ty, thử trên vài file mẫu trước khi dùng thật.

Điểm chung: skill không phải phép màu, nó chỉ là quy trình của bạn được viết ra và lưu lại để AI làm theo nhất quán.

An toàn: coi skill như phần mềm

Skill có thể chứa script chạy trên máy bạn, nên đừng cài tuỳ tiện.

• Chỉ dùng skill do bạn tự viết hoặc từ nguồn đáng tin như Anthropic.
• Với skill của người khác: mở SKILL.md và mọi script đi kèm, kiểm tra các lệnh gọi mạng bên ngoài trước khi dùng. Skill lạ có thể dẫn tới rò rỉ dữ liệu.
• Việc có tác động lớn (deploy, xoá dữ liệu, gửi email hàng loạt) nên khoá bằng disable-model-invocation: true.

Checklist 15 phút để có skill đầu tiên

1. Chọn một việc bạn đã dán hướng dẫn cho AI từ ba lần trở lên.
2. Tạo thư mục ~/.claude/skills/ten-skill/ và file SKILL.md.
3. Viết description có đủ "làm gì" và "khi nào dùng".
4. Viết các bước đánh số, thêm một ví dụ đầu vào và đầu ra.
5. Mở Claude Code, thử gọi tự động bằng một câu hỏi tự nhiên, rồi thử gọi /ten-skill.
6. Không khớp? Sửa description trước, sau đó mới sửa nội dung.

Tài liệu tham khảo

• Tổng quan Agent Skills (Anthropic)
• Skill trong Claude Code
• Kho skill của Anthropic trên GitHub
• Bài kỹ thuật về Agent Skills

Muốn xem các skill đã chọn lọc theo từng nhóm việc (thiết kế, viết nội dung, tài liệu văn phòng), vào mục Skill trong Tiện ích AI.