Agent skills là gì, cài skill lạ từ GitHub có an toàn không?
Agent skills là thư mục hướng dẫn mà trợ lý AI đọc để làm đúng một việc. Lấy skill ở đâu, chép vào đâu, cài skill lạ có rủi ro gì?
Mục lục
Agent skills là những thư mục hướng dẫn có file SKILL.md, giúp trợ lý AI làm một việc theo đúng cách bạn muốn.
Anthropic làm ra định dạng này, rồi mở thành chuẩn chung để nhiều công cụ AI cùng đọc.
Chào bạn, Tuấn đây. Tuấn dùng OMP (oh my pi) hằng ngày, trong đó có một skill viết tiêu đề cho blog.
Nghe thì to tát. Nhưng mở ra chỉ là một thư mục, vài file chữ!
Bài này nói agent skills khác plugin và MCP ra sao, lấy ở đâu, chép vào đâu. Quan trọng nhất: cài skill lạ từ GitHub thì soát gì.
TÓM TẮT NHANH
- Skill là thư mục có
SKILL.md, tối thiểu khoánamevàdescription(mục 1.1). - AI chỉ đọc tên và mô tả trước, cần mới đọc hết, nên cài nhiều skill vẫn nhẹ (mục 2.3).
- Chuẩn và phần lớn kho skill miễn phí; tiền nằm ở trợ lý AI (mục 3).
- Script trong skill chạy bằng quyền của bạn: đọc hết trước khi cài (mục 5.1).
- Mỗi công cụ một thư mục skill; Codex và Gemini CLI cùng đọc
.agents/skills/(mục 5.3).
1. Agent skills là gì?
Thử hình dung bạn viết sẵn một tờ hướng dẫn cho người mới vào làm. Skill là tờ hướng dẫn đó, viết cho trợ lý AI.
Trang chủ của chuẩn gọi agent skills là định dạng mở, gọn nhẹ để thêm kiến thức và quy trình cho AI agent. AI agent là trợ lý AI tự đọc file, chạy lệnh, không chỉ trả lời chat.
Bạn không phải dán lại lời dặn mỗi lần chat. Trợ lý AI tự mở skill khi việc bạn nhờ khớp với mô tả của nó.
1.1 Một skill gồm những file nào
Một skill là một thư mục, file chính tên là SKILL.md.
Đầu file là vài dòng khai báo (frontmatter), tối thiểu có name và description (skill làm gì, dùng khi nào). Phía dưới là lời hướng dẫn viết bằng chữ thường.
Một SKILL.md nhỏ nhất chỉ cần chừng này:
Muốn kèm thêm thì để vào ba thư mục con tuỳ chọn: scripts/ cho code, references/ cho tài liệu, assets/ cho mẫu và hình.
Muốn chỉnh sâu hơn, đây là 6 khoá frontmatter theo đặc tả chính thức của chuẩn (đọc 21/10/2026):
| Khoá | Bắt buộc | Giới hạn |
|---|---|---|
name | Có | ≤ 64 ký tự, chữ thường, số, gạch nối; trùng tên thư mục |
description | Có | 1–1.024 ký tự: skill làm gì, khi nào dùng |
license | Không | Tên giấy phép hoặc file giấy phép kèm theo |
compatibility | Không | ≤ 500 ký tự: môi trường cần có |
metadata | Không | Cặp khoá–giá trị tuỳ ý |
allowed-tools | Không | Công cụ được duyệt sẵn, cách nhau dấu cách; còn thử nghiệm |
Đặc tả khuyên giữ SKILL.md dưới 500 dòng, phần dài tách ra file riêng.
1.2 Ai làm ra agent skills, ra khi nào
Anthropic, công ty làm ra Claude, giới thiệu Agent Skills trong bài viết ra mắt của Anthropic ngày 16/10/2025.
Ngày 18/12/2025, bài được cập nhật: Agent Skills đã thành chuẩn mở cho nhiều nền tảng.
Đặc tả nằm ở agentskills.io, mã nguồn ở trang mã nguồn chính thức trên GitHub, giấy phép Apache-2.0.
2. Agent skills giúp trợ lý AI làm được gì
Không phải phép màu đâu. Skill chỉ giúp AI làm đúng cách bạn muốn, đều đặn, không phải nhắc lại.
2.1 Làm một việc lặp lại theo đúng cách của bạn
Ví dụ thật: skill viet-tieu-de Tuấn dùng viết tiêu đề cho blog, chạy trong OMP.
Thư mục chỉ có hai file: SKILL.md là lời dặn chính, kieu-tieu-de.md chứa 10 kiểu tiêu đề kèm ví dụ mà skill dặn đọc trước khi viết.
Phần đầu SKILL.md chỉ có hai khoá bắt buộc, mô tả nói rõ skill viết title, seo_title, meta và lúc nào dùng:
Nhờ dòng mô tả đó, AI biết khi nào phải mở skill ra đọc.
2.2 Chạy script kèm theo để ra kết quả chắc
Skill có thể kèm script trong scripts/ để AI chạy, thay vì tự viết code mới mỗi lần.
Trang tài liệu của Anthropic ghi: code của script không vào ngữ cảnh (phần chữ AI phải “nhớ” trong cuộc chat), chỉ kết quả đi vào. Vậy là đỡ token, kết quả lại ổn định hơn.
2.3 Cài nhiều skill mà AI chỉ đọc khi cần
Cài 20 skill có làm ngữ cảnh AI phình to không? Ít hơn bạn nghĩ nhiều!
Chuẩn nạp agent skills theo ba tầng. Lúc khởi động, AI chỉ đọc tên và mô tả của mọi skill, khoảng 100 token mỗi skill.
Khi việc bạn nhờ khớp mô tả, nó mới đọc toàn bộ SKILL.md, đặc tả khuyên dưới 5.000 token. File kèm chỉ được đọc hoặc chạy khi cần.
2.4 Một skill, nhiều trợ lý AI đọc được
Điểm đáng giá nhất của chuẩn chung: viết một skill, mang sang công cụ khác vẫn dùng được.
Trang danh sách công cụ hỗ trợ liệt kê 46 công cụ đọc được agent skills (Tuấn đếm ngày 21/10/2026), có Claude Code, ChatGPT và Codex, Gemini CLI, GitHub Copilot, Cursor.
Ngay cả Excel cũng đọc: Microsoft yêu cầu mỗi skill cho Copilot trong Excel là một thư mục có SKILL.md. Tuấn đã viết về Copilot trong Excel làm báo cáo, dọn dữ liệu.
Có điều, skill không tự đồng bộ: Anthropic ghi rõ claude.ai, API và Claude Code là ba chỗ riêng, nơi nào cài nơi đó.
3. Dùng agent skills có mất tiền không
Bản thân chuẩn và phần lớn kho skill công khai đều miễn phí.
Tiền thật nằm ở trợ lý AI bạn dùng để chạy agent skills. Bảng dưới gom các khoản, xem ngày 21/10/2026:
| Thứ | Giấy phép / điều kiện | Chi phí |
|---|---|---|
| Chuẩn và đặc tả | Apache-2.0 | Miễn phí |
| Kho skill của Anthropic | Nhiều skill Apache 2.0; docx, pdf, pptx, xlsx chỉ công khai mã nguồn | Miễn phí; bốn skill tài liệu theo điều khoản riêng |
| Kho skill của Google, của Addy Osmani | Apache-2.0, MIT | Miễn phí |
| Skill tự làm trên claude.ai | Pro, Max, Team, Enterprise, bật code execution | Theo gói Claude |
| Skill qua Claude API | Cần code execution tool | Theo giá API |
Kho anthropics/skills không có file giấy phép ở gốc: mỗi thư mục skill có file riêng, ví dụ giấy phép của skill docx. Dùng cho việc thương mại thì đọc đúng file đó trước.
Còn một khoản ẩn đấy! Tài liệu Claude Code ghi: tên và mô tả skill nằm trong ngữ cảnh ở mọi lượt chat, nên tính vào lượng dùng kể cả khi skill không chạy.
Mỗi skill tốn khoảng 100 token như vậy (theo tài liệu Anthropic). Skill nào cả tháng không dùng thì gỡ cho nhẹ.
4. Skill khác plugin và MCP ở đâu
Ba chữ này hay bị dùng lẫn, dù mỗi thứ làm một việc khác hẳn!
| Là gì | Ai chạy | Cài thế nào | |
|---|---|---|---|
| Skill | Thư mục hướng dẫn có SKILL.md, có thể kèm script | AI tự đọc khi cần | Chép thư mục hoặc gõ lệnh |
| Plugin (Claude Code) | Gói skill, agent, hook, MCP server cài một lần | Công cụ nạp cả gói | Lệnh /plugin install |
| MCP | Chuẩn mở nối AI với hệ thống ngoài | Server chạy riêng | Chạy server rồi khai cấu hình |
Nói gọn: skill dạy cách làm, MCP cho đường nối tới dữ liệu, plugin là cái hộp đựng chung.
4.1 Skill với MCP
Bài giải thích của Google Cloud so sánh gọn: skill là “trí nhớ quy trình” gồm lời dặn và script chạy tại chỗ, còn MCP nối agent với dữ liệu sống bên ngoài.
Hai thứ bổ sung cho nhau: một skill thường chứa luôn lời dặn cách hỏi một MCP server.
4.2 Skill với plugin
Agent skills không cần plugin vẫn chạy. Tài liệu plugin của Claude Code ghi: skill lưu ở ~/.claude/skills/ dùng được ở mọi dự án trên máy bạn.
Plugin chỉ cần khi bạn muốn cài cả bộ bằng một lệnh, hoặc gửi bộ của mình cho đồng nghiệp.
5. Lấy agent skills trên GitHub và cài vào đâu
Phần lớn bộ agent skills công khai nằm trên GitHub. Chưa quen thì đọc trước bài kho mã nguồn trên GitHub hoạt động thế nào để biết repo, README, LICENSE là gì.
5.1 Trước khi cài: soát skill như soát phần mềm
Lưu ý trước mọi bước cài: skill có thể kèm script, và script đó chạy bằng quyền tài khoản của bạn.
Anthropic dặn chỉ dùng skill tự làm hoặc của Anthropic, và coi việc cài skill như cài phần mềm.
Skill độc có thể khiến AI gọi công cụ, chạy code lệch mô tả, thậm chí gửi dữ liệu ra ngoài. Trong Claude Code, skill có toàn quyền mạng như mọi chương trình khác, còn plugin chạy code với quyền người dùng của bạn.
Google Cloud thêm hai rủi ro: tấn công chuỗi cung ứng (kho bị chèn mã độc ở bản sau) và prompt injection gián tiếp (lời dặn độc giấu trong nội dung AI đọc).
Trên Mac, quyền của trợ lý AI đang là chuyện nóng: Apple sắp siết quyền đọc toàn ổ đĩa trên Mac cũng vì AI agent.
Trước khi cài một bộ agent skills lạ, bạn làm đủ năm việc:
- Đọc hết
SKILL.md, xem lời dặn có lệch mô tả không. - Mở từng file trong
scripts/, tìm lệnh gửi dữ liệu ra mạng hoặc đọc file ngoài thư mục skill. - Xem skill có tải nội dung từ URL ngoài không, vì nội dung đó đổi được sau khi cài.
- Đọc giấy phép: ở gốc kho, hoặc trong từng thư mục skill như kho của Anthropic.
- Xem kho còn được cập nhật, có người giữ, nhiều người dùng không.
Máy chứa dữ liệu nhạy cảm mà bạn không đọc được script thì đừng cài.
5.2 Kho skill có sẵn trên GitHub
Ba kho dễ bắt đầu nhất, kiểm ngày 21/10/2026:
| Kho | Có gì | Giấy phép |
|---|---|---|
anthropics/skills | Skill mẫu về thiết kế, kỹ thuật, doanh nghiệp, tài liệu; có thư mục template | Nhiều skill Apache 2.0; bốn skill tài liệu chỉ công khai mã nguồn |
google/skills | Skill cho BigQuery, Cloud Run, GKE và Google Cloud khác | Apache-2.0 |
addyosmani/agent-skills | 25 skill lập trình: review code, viết test, quy trình Git | MIT |
README của Anthropic ghi skill trong kho chỉ để minh hoạ, học tập. Cách Claude thật sự làm có thể khác, nên thử kỹ trên máy mình trước.
5.3 Chép thư mục skill vào đúng chỗ
Cách thủ công nhất để cài agent skills: tải thư mục skill về, chép vào chỗ công cụ của bạn đọc.
Thư mục cá nhân dùng cho mọi dự án; thư mục dự án chỉ dùng trong dự án đó, gửi kèm được cho cả nhóm.
| Công cụ | Thư mục cá nhân | Thư mục dự án |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | $HOME/.agents/skills | .agents/skills (quét từ thư mục đang mở lên gốc repo) |
| Gemini CLI | ~/.gemini/skills/ hoặc ~/.agents/skills/ | .gemini/skills/ hoặc .agents/skills/ |
| claude.ai | Nén skill thành zip, tải lên ở Settings > Features | Không có |
Skill viet-tieu-de của Tuấn nằm trong .agents/skills/ của thư mục làm blog, đúng chỗ Codex và Gemini CLI cùng đọc.
5.4 Cài bằng một lệnh
Muốn nhanh hơn thì cài agent skills bằng lệnh: mở cửa sổ dòng lệnh rồi gõ lệnh trong thư mục dự án.
CLI skills của Vercel cần Node.js 22.20 trở lên. Xem trước kho có những skill nào, chưa cài gì:
npx skills add anthropics/skills --listThấy ổn mới bỏ --list để cài. Mặc định skill cài vào dự án hiện tại; thêm -g để dùng cho mọi dự án.
CLI này thu thập số liệu dùng ẩn danh; muốn tắt thì đặt DISABLE_TELEMETRY=1 hoặc DO_NOT_TRACK=1 trước lệnh.
Trong Claude Code, kho của Anthropic cài như plugin, gõ ngay trong khung chat:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skillsCác lệnh hay dùng khác (theo tài liệu từng công cụ):
| Lệnh | Làm gì | Mặc định |
|---|---|---|
npx skills update | Cập nhật skill đã cài | Hỏi phạm vi dự án hay toàn máy; -y để tự chọn |
npx skills remove <tên> | Gỡ skill | — |
gemini skills install <url-git> | Cài skill cho Gemini CLI từ repo Git hoặc thư mục | Hỏi xác nhận bảo mật; --consent để bỏ qua |
$skill-installer <tên> | Cài skill tuyển chọn trong Codex | — |
omp skill | Quản lý skill của OMP (bản 18.12.3) | — |
Tuấn chưa chạy npx skills trong bài này; lệnh và cờ lấy từ README và tài liệu lệnh của Vercel, đọc ngày 21/10/2026.
6. Ai nên và không nên dùng agent skills
Ba câu hỏi giúp bạn tự quyết:
Bạn chưa cần dùng agent skills khi:
- Bạn chỉ hỏi đáp lặt vặt, mỗi lần một chuyện khác.
- Máy có dữ liệu nhạy cảm mà bạn không đọc nổi script.
- App chat bạn dùng không hỗ trợ skill.
Cách thử an toàn nhất là tự viết skill đầu tiên. Bạn biết chắc trong đó có gì, vì chính bạn viết!
7. Câu hỏi thường gặp về agent skills
7.1 SKILL.md là file gì?
File chính của mỗi skill: frontmatter YAML ở đầu, lời dặn Markdown bên dưới (mục 1.1).
7.2 Có cần biết code để dùng agent skills không?
Không bắt buộc. Google Cloud ghi skill viết bằng ngôn ngữ đơn giản, không cần kinh nghiệm lập trình.
Có điều, cài bằng lệnh thì cần mở Terminal (mục 5.4), soát script thì cần biết chút code.
7.3 Agent skills có chạy trong ChatGPT, Gemini không?
ChatGPT và Codex có trong danh sách hỗ trợ; tài liệu OpenAI ghi skill mở rộng được cả hai. Gemini CLI cũng đọc skill (mục 5.3), nhưng từ 18/06/2026 người dùng gói miễn phí và Google One đã chuyển sang Antigravity CLI.
Google có nhắc nền tảng Gemini cho doanh nghiệp, còn app Gemini thường thì Tuấn chưa thấy nguồn chính thức nói có đọc skill.
7.4 Agent skill khác fine-tune ở đâu?
Fine-tune nhét kiến thức vào trọng số model, tốn kém, khó cập nhật. Skill là “trí nhớ quy trình” nằm ngoài, đổi được, AI đọc khi cần (Google Cloud).
7.5 Tự viết một skill có khó không?
Không khó. Tối thiểu là một thư mục, một file SKILL.md có name, description và lời dặn bên dưới.
Kho của Anthropic có sẵn thư mục template để chép làm khung.
Agent skills chỉ là thư mục chữ, nhưng biến lời dặn của bạn thành thói quen của trợ lý AI. Cứ đọc kỹ trước khi cài, như cài phần mềm.
Bạn đang cho trợ lý AI làm việc gì lặp đi lặp lại mà muốn đóng thành skill?
Để lại bình luận