Table of Contents
Agent Skills là cách đóng gói kinh nghiệm làm việc thành một thư mục hướng dẫn để AI agent tự nạp vào đúng lúc cần — thay vì bạn phải dặn lại từ đầu trong mỗi phiên chat. Anthropic công bố chuẩn mở này cuối năm 2025, và kho skill mẫu chính chủ trên GitHub đang được cộng đồng dùng lại rất nhiều. Bài này giải thích Agent Skills hoạt động ra sao, hai kho skills mã nguồn mở đáng xem, và cách tự viết skill đầu tiên cho việc bạn lặp lại hằng ngày.
Vì sao AI agent cứ “quên” cách làm việc của bạn
Bạn có lẽ cũng từng rơi vào cảnh này: cùng một việc, tuần nào cũng phải giải thích lại cho AI từ đầu — viết báo cáo theo mẫu nào, kiểm tra gì trước khi bật workflow, đặt tên file ra sao. Prompt càng dài, AI càng dễ bỏ sót một nửa, và lần sau bạn lại nhắc lại y hệt. Vấn đề không nằm ở model kém thông minh, mà ở chỗ mỗi phiên chat bắt đầu từ con số 0: model biết rất nhiều kiến thức chung, nhưng không biết quy trình riêng của bạn.
Agent Skills sinh ra để lấp đúng khoảng trống đó: thay vì nhét toàn bộ quy trình vào prompt mỗi lần, bạn viết nó một lần thành một “kỹ năng” dùng lại, agent tự lấy ra khi gặp đúng việc. Người dùng n8n sẽ thấy quen ngay — giống như đóng gói một quy trình hay dùng thành sub-workflow để gọi lại, chỉ khác là quy trình ở đây viết bằng chữ để agent đọc và làm theo.
Agent Skills là gì — nói gọn trong một ví dụ
Theo cách Anthropic mô tả trong bài kỹ thuật giới thiệu Agent Skills, một skill là thư mục chứa hướng dẫn, script và tài liệu tham khảo mà agent có thể tìm thấy và nạp động để làm tốt hơn một nhiệm vụ chuyên biệt. Bản thân Anthropic ví việc viết skill giống như soạn cẩm nang onboarding cho nhân viên mới: thay vì xây một agent riêng cho từng việc, bạn dạy agent chung một “nghề” bằng cách ghi lại quy trình làm việc của mình.
Điểm khác biệt lớn nhất so với prompt thường nằm ở cách nạp. Agent không đọc toàn bộ skill ngay từ đầu. Cơ chế này gọi là progressive disclosure — hé lộ dần theo ba tầng:
- Tầng metadata: lúc khởi động, agent chỉ nạp tên (name) và mô tả (description) của từng skill vào prompt hệ thống — vừa đủ để biết skill nào dùng cho việc gì.
- Tầng SKILL.md: khi nhiệm vụ hiện tại khớp với mô tả, agent mới đọc toàn bộ file hướng dẫn chính.
- Tầng tài liệu đính kèm: các file tham khảo, script, mẫu biểu chỉ được mở khi thật sự cần tới.
Nhờ vậy, bạn có thể nhét cả một quy trình dài vào skill mà không làm nặng cửa sổ ngữ cảnh của mọi phiên chat — agent chỉ trả token cho phần nó thực sự dùng. Một file SKILL.md tối thiểu chỉ cần hai trường bắt buộc ở đầu file: name (tên duy nhất, viết thường, nối bằng gạch ngang) và description (mô tả skill làm gì và dùng khi nào). Phần còn lại là hướng dẫn bằng Markdown: các bước, ví dụ, lưu ý, checklist.
Hai kho skills mã nguồn mở đáng xem trước
Chuẩn Agent Skills hiện là chuẩn mở, đặt tại agentskills.io. Hai kho dưới đây là chỗ bắt đầu thực tế nhất, vì cả hai đều công khai toàn bộ nội dung để bạn đọc, dùng lại và học theo.
Kho chính chủ: anthropics/skills. Đây là kho ví dụ do chính Anthropic phát hành, gồm skill từ sáng tạo tới kỹ thuật (tạo MCP server, kiểm thử web app) và công việc doanh nghiệp. Đáng chú ý nhất là bộ bốn skill docx, pdf, pptx, xlsx — chính là những skill đang chạy phía sau tính năng tạo và sửa tài liệu của Claude. Phần lớn skill trong kho dùng giấy phép Apache 2.0, tức bạn được dùng lại và chỉnh sửa. Kho cũng kèm sẵn thư mục template để bắt đầu viết skill mới, và bản đặc tả của chuẩn.
Kho thực chiến: agent-skills của Addy Osmani. Khác với kho chính chủ thiên về ví dụ, kho này gồm 26 skill đóng gói quy trình làm phần mềm theo vòng đời đầy đủ: hỏi yêu cầu, viết spec, chia task, code, test, review, ship. Kèm theo là 10 lệnh tắt như /spec, /plan, /build, /test, /review, /ship, mỗi lệnh tự kích hoạt đúng skill cho từng giai đoạn. Cài nhanh nhất bằng lệnh npx skills add addyosmani/agent-skills, hoặc đăng ký làm plugin marketplace trong Claude Code giống kho chính chủ.
| Kho skills | Điểm mạnh | Hợp với ai |
|---|---|---|
| anthropics/skills | Skill mẫu chính chủ, kèm bộ skill tài liệu đang chạy thật trong Claude | Người muốn học đúng chuẩn viết skill |
| addyosmani/agent-skills | 26 skill theo vòng đời dev, có lệnh tắt từng giai đoạn | Dev dùng AI agent code hằng ngày, cần quy trình chặt chẽ |
Cách nạp skill cho agent của bạn
Với Claude Code, kho chính chủ cài qua plugin marketplace bằng hai lệnh:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
Lệnh thứ hai cài bộ skill tài liệu; thay bằng example-skills@anthropic-agent-skills nếu muốn cả bộ ví dụ. Sau đó chỉ cần gọi bằng câu tự nhiên, ví dụ nhờ Claude dùng PDF skill để trích các trường trong một file PDF. Trên Claude.ai, các skill ví dụ của kho chính chủ đã có sẵn cho gói trả phí, theo README của repo (kiểm tra ngày 21/11/2026).
Skill tự viết thì không cần qua marketplace: đặt vào thư mục cá nhân ~/.claude/skills để dùng cho mọi dự án, hoặc .claude/skills trong thư mục dự án để commit cùng repo cho cả nhóm dùng chung. Lưu ý nhỏ: skill chạy được trên nhiều agent khác nhau vì bản chất nó là Markdown, nhưng hành vi cụ thể vẫn phụ thuộc vào từng công cụ — skill gọi công cụ riêng của Claude có thể cần chỉnh lại khi mang sang agent khác.
Tự viết skill đầu tiên: checklist rà soát workflow n8n trước khi bật
Ví dụ thực tế cho người dùng n8n: một skill tên n8n-workflow-review — mỗi lần chuẩn bị bật một workflow mới, agent tự rà soát theo checklist thay vì bạn phải nhớ từng mục. Cách làm gói gọn trong năm bước:
Bước 1: tạo thư mục và file SKILL.md. Cấu trúc tối thiểu chỉ có vậy:
n8n-workflow-review/
└── SKILL.md
Bước 2: viết frontmatter — phần quan trọng nhất. Hai trường bắt buộc, và description chính là “công tắc” quyết định agent có dùng skill này không — phải ghi rõ làm gì và khi nào dùng:
---
name: n8n-workflow-review
description: Rà soát workflow n8n trước khi bật production — kiểm tra credential, webhook URL, múi giờ, error workflow và chạy thử. Dùng khi người dùng nhờ kiểm tra hoặc bật một workflow n8n mới.
---
# Rà soát workflow n8n trước khi bật
## Kiểm tra theo thứ tự
1. Credential còn hạn không, có đang dùng đúng tài khoản không.
2. WEBHOOK_URL trỏ đúng domain đã gắn, webhook ở trạng thái production.
3. Múi giờ đặt Asia/Ho_Chi_Minh, lịch chạy đúng giờ Việt Nam.
4. Đã gắn error workflow để báo lỗi thay vì im lặng thất bại.
5. Chạy thử bằng dữ liệu mẫu trước, chỉ bật production khi test đã pass.
Bước 3: viết hướng dẫn theo bước trong thân file. Ghi đúng thứ tự bạn vẫn làm, kèm lỗi thường gặp ở mỗi bước — ví dụ webhook không chạy sau khi gắn domain thường do sai WEBHOOK_URL. Càng ghi cụ thể bằng kinh nghiệm thật, agent làm theo càng giống ý bạn.
Bước 4: tách file tham khảo nếu skill dài ra. Khi SKILL.md bắt đầu phình to, chuyển phần chi tiết sang file riêng trong cùng thư mục — ví dụ references/common-errors.md liệt kê lỗi thường gặp — và chỉ nhắc tên file trong SKILL.md. Agent sẽ tự mở khi cần.
Bước 5: thử thật rồi sửa. Chạy thử skill với hai ba workflow khác nhau, xem agent dùng nó ra sao, chỗ nào hiểu sai thì sửa lại description và các bước. Anthropic khuyên đúng cách này: quan sát agent vấp ở đâu, rồi viết skill lấp đúng chỗ vấp đó. Nếu bạn chưa từng cho agent tự chạy việc với n8n, có thể xem lại cách tạo AI Agent bằng n8n để thấy agent trong n8n thường được giao việc ra sao rồi mới đóng gói thành skill.
Ba lỗi hay gặp khi mới viết skill
Thứ nhất, description viết chung chung. Kiểu “skill giúp làm việc hiệu quả” không nói lên việc gì, agent không biết khi nào nên dùng. Anthropic nhấn mạnh description là cơ chế kích hoạt chính của skill, nên phải ghi rõ làm gì và dùng trong tình huống nào.
Thứ hai, nhồi tất cả vào một file SKILL.md dài dằng dặc. Agent vẫn đọc được, nhưng bạn bắt mọi phiên chat trả token cho cả phần ít khi dùng tới. Tách phần chi tiết ra file riêng, agent chỉ mở khi cần.
Thứ ba, cài skill từ nguồn lạ mà không đọc qua. Skill có thể kèm script và hướng dẫn agent kết nối ra ngoài, nên một skill độc hại có thể trở thành cửa sau. Anthropic cảnh báo chỉ cài skill từ nguồn tin cậy, và với nguồn ít tin cậy thì đọc kỹ nội dung file, đặc biệt là script, trước khi dùng. Kho chính chủ và kho của Addy Osmani đều công khai toàn bộ nội dung nên bạn có thể rà soát trước khi cài.
Skill có thay thế prompt và MCP không?
Không. Ba thứ xếp chồng lên nhau chứ không loại nhau: prompt là chỉ dẫn cho một lần làm việc cụ thể; MCP cho agent thêm công cụ để chạm tới dữ liệu và hệ thống bên ngoài; skill dạy agent quy trình — làm theo thứ tự nào, kiểm tra cái gì, chuẩn đầu ra ra sao. Một agent có thể vừa gọi công cụ qua MCP, vừa làm theo skill để biết báo cáo tuần phải tổng hợp đúng mẫu của bạn. Nếu bạn đang cho agent chạy trực tiếp trên máy, nên đọc thêm bài về OpenClaw để thấy vì sao checklist an toàn càng quan trọng khi agent có quyền thao tác thật.
Agent Skills không phải tính năng hào nhoáng, mà là cách làm cho AI agent nhớ được “cách làm việc của riêng bạn” — viết một lần, dùng lại mãi, chia sẻ được cho cả nhóm. Kho mẫu của Anthropic và bộ 26 skill của Addy Osmani là hai chỗ bắt đầu tốt nhất lúc này, vì cả hai đều mã nguồn mở và đã có người dùng thật rà soát. Số liệu và cách cài đặt trong bài được kiểm tra trực tiếp trên README của hai repo và bài kỹ thuật của Anthropic ngày 21/11/2026.
Việc lặp lại nào trong tuần của bạn tốn nhiều thời gian giải thích lại cho AI nhất — và nếu đóng gói nó thành một skill, bước đầu tiên trong skill đó sẽ là gì?