Hướng dẫn toàn tập cho người mới bắt đầu về Agent Skills: Xây dựng kỹ năng đầu tiên của bạn

Tất cả những ai làm việc với AI đều từng gặp vấn đề này:

Bạn dạy nó một điều gì đó, hôm sau bắt đầu một cuộc trò chuyện mới, và mọi thứ lại quay về vạch xuất phát.

Bạn dành ba ngày để tinh chỉnh một quy trình, qua lại với Claude để có được kết quả như ý, nhưng rồi hôm sau lại phải giải thích lại tất cả từ đầu.

Bạn lưu các prompt vào ghi chú và dán chúng vào mỗi lần sử dụng, nhưng dán một hướng dẫn dài 500 từ mỗi ngày trong suốt một tháng khiến bạn tự hỏi: đây có thực sự là cách AI nên được sử dụng hay không?

Skill ra đời đặc biệt để giải quyết vấn đề này.

Nó được Anthropic ra mắt vào tháng 10 năm 2025 và trở thành một tiêu chuẩn mở vào tháng 12.

Ngày nay, cả internet đang hô vang "Skills thay đổi năng suất", nhưng hầu hết mọi người mới chỉ nghe đến nó mà chưa thực sự hiểu sự khác biệt giữa Skills, prompt, knowledge base, MCP và agent — chứ chưa nói đến việc tự xây dựng một cái.

Bài viết này sẽ giải thích tất cả cùng một lúc.

Trước tiên, hãy hiểu một điều: Skills không bị ràng buộc với bất kỳ AI cụ thể nào.

Nhiều người nghe nói "Claude Skills" và nghĩ đó là tính năng độc quyền của Claude, nhưng thực tế không phải vậy. Agent Skills là một tiêu chuẩn mở do Anthropic khởi xướng; Claude chỉ là bên triển khai hàng đầu.

Cùng một thư mục Skill có thể được đặt trong ~/.claude/skills/ cho Claude Code, ~/.cursor/skills/ cho Cursor, hoặc được sử dụng với OpenAI Codex, Gemini CLI, VS Code Copilot và JetBrains Junie.

Skill bạn viết hôm nay có thể được di chuyển liền mạch sang một Agent khác vào ngày mai; khoản đầu tư của bạn sẽ không bị khóa vào một công ty duy nhất.

Bài viết này sẽ chủ yếu sử dụng Claude Code làm ví dụ (vì nó là người đặt ra tiêu chuẩn với hệ sinh thái hoàn chỉnh nhất), nhưng tất cả các nguyên tắc, phương pháp viết và kinh nghiệm khắc phục sự cố đều áp dụng cho tất cả các công cụ AI hỗ trợ Agent Skills.

Khi bạn thấy "Claude Skill", hãy nghĩ là "Agent Skill."

1. Skill Chính Xác Là Gì?

Định nghĩa trong một câu:

Skill là một thư mục, xoay quanh một tệp Markdown có tên SKILL.md, cho AI biết cách thực hiện ổn định một loại công việc chuyên nghiệp cụ thể theo một SOP (Quy trình vận hành chuẩn) mà bạn xác định.

Nó đóng gói "cách một việc nào đó nên được thực hiện" thành một mô-đun khả năng có thể tái sử dụng và được kích hoạt tự động.

Về bản chất, nó là một "gói mở rộng" cho AI đa năng.

AI đa năng giống như một cỗ máy thô sơ — thông minh nhưng thiếu kiến thức chuyên ngành. Skill là một mô-đun cắm và chạy: cài đặt một "Skill Phong cách Xiaohongshu", AI ngay lập tức trở thành một biên tập viên hiểu thương hiệu của bạn; cài đặt một "Skill Báo cáo Tuần", AI ngay lập tức tạo báo cáo theo định dạng công ty của bạn.

Và "gói mở rộng" này không kén chọn AI: Claude Code, Codex, Cursor, Gemini CLI và Junie đều nhận dạng cùng một định dạng.

Bạn đang tạo một Agent Skill, không phải một tập lệnh độc quyền của Claude.

Ranh giới với bốn khái niệm khác:

Nhiều người nhầm lẫn Skills với prompt, knowledge base, MCP và agent, nhưng chúng khác biệt:

Các phép loại suy phổ biến:

• Prompt = Gửi một tin nhắn WeChat cho nhân viên; họ sẽ quên nó ngay sau khi hoàn thành.
• Skill = Viết một cuốn sách hướng dẫn cho nhân viên và đặt lên bàn của họ, cùng với một hộp dụng cụ.
• Knowledge Base = Một thư viện cho bạn biết những gì tồn tại trên thế giới.
• MCP = Các dụng cụ nhà bếp khác nhau giải quyết vấn đề "có làm được không".
• Agent = Toàn bộ hệ thống nhân viên, có trí nhớ và khả năng ra quyết định; Skill chỉ là một phần của nó.

Bốn khái niệm này không loại trừ lẫn nhau.

Trong công việc thực tế, chúng thường được kết hợp: MCP cho phép Claude kết nối với Reddit để thu thập dữ liệu, Skill dạy nó cách lọc/phân loại/gợi ý dữ liệu đó, Knowledge Base cung cấp tài liệu thương hiệu, và Agent là toàn bộ hệ thống chạy quy trình.

2. Kiến trúc và Cơ chế Hoạt động

Cấu trúc Tệp

Mỗi thư mục con giải quyết một vấn đề khác nhau nhưng phục vụ cùng một mục tiêu — tiết kiệm ngữ cảnh và ổn định chất lượng:

• scripts/: Tính toán chính xác mà không tiêu tốn ngữ cảnh.
• references/: Được tải theo yêu cầu để tránh lãng phí dung lượng.
• assets/: Chuẩn hóa các định dạng đầu ra.

Cơ chế Tiết lộ Dần Ba Lớp — Linh hồn của Thiết kế Skill

Cơ chế cốt lõi của Skill là tải ba lớp, đó là lý do tại sao hàng chục Skill có thể cùng tồn tại mà không làm bùng nổ ngữ cảnh:

Ví dụ:

Khi Claude khởi động, nó chỉ lướt qua "bìa" của tất cả các Skill để quyết định cái nào sẽ sử dụng; chỉ khi đến lúc làm việc, nó mới mở nội dung chính; và chỉ khi cần kiểm tra một phụ lục, nó mới chuyển đến các tham chiếu.

Cơ chế này cho phép bạn có 17 Skill hoạt động đồng thời mà không làm tắc nghẽn cửa sổ ngữ cảnh 200K.

Siêu dữ liệu YAML

Mô tả các trường:

Mô tả Quyết định Thành công hay Thất bại

Trong kiến trúc ba lớp, mô tả L1 là quan trọng nhất — nó quyết định liệu Skill của bạn có được kích hoạt hay không.

Các sự thật chính:

1. Claude chỉ đọc mô tả của tất cả các Skill khi khởi động.
2. Nó đưa ra phán đoán ngữ nghĩa dựa trên mô tả, không phải đối sánh từ khóa.
3. Claude có xu hướng thận trọng: nếu không chắc chắn, nó sẽ không kích hoạt. Trong các thử nghiệm, mô tả mơ hồ có độ chính xác kích hoạt chỉ 55%.

Ví dụ tiêu cực (sẽ không bao giờ được kích hoạt):

[Mô tả mơ hồ]

Ví dụ tích cực (phong cách "quyết đoán" được Anthropic khuyến nghị):

[Mô tả cụ thể]

Ba Nguyên tắc Vàng để viết mô tả:

1. Viết CÁI GÌ + KHI NÀO cùng nhau: Nói nó làm gì và khi nào nên sử dụng nó.
2. Liệt kê các từ kích hoạt bằng cả tiếng Trung và tiếng Anh: Phù hợp với bất cứ điều gì người dùng nói.
3. Hãy quyết đoán thay vì thận trọng: Anthropic nói rõ rằng vấn đề chính là kích hoạt dưới mức (under-triggering).

3. Nguyên tắc Cốt lõi để Viết Skills Tốt

Ba Nguyên tắc Chính

Cách xử lý quyền tự do:

Năm Mẫu Thiết kế

Anthropic đã tổng kết năm mẫu thiết kế Skill từ những người dùng đầu tiên:

Các Skill hữu ích thường kết hợp nhiều mẫu. Bạn không cần phải tuân theo chúng một cách cứng nhắc, nhưng biết chúng tồn tại sẽ giúp bạn thiết kế có cấu trúc hơn.

Nguyên tắc Vàng: Sử dụng "Tại sao" thay vì "Phải làm"

Đây là một câu trích từ mã nguồn của skill-creator (meta-skill chính thức của Anthropic để tạo Skill):

"Hãy cố gắng giải thích cho mô hình tại sao mọi thứ lại quan trọng thay vì sử dụng những câu PHẢI LÀM nặng nề và cứng nhắc."

Ví dụ tiêu cực:

[Các quy tắc PHẢI LÀM nghiêm ngặt]

Ví dụ tích cực:

[Giải thích lý do]

Trong trường hợp đầu tiên, Claude sẽ chỉ tuân theo hai quy tắc đó. Trong các tình huống không được quy tắc đề cập (như một lệnh có vẻ an toàn nhưng rủi ro), nó sẽ bị mắc kẹt. Trong trường hợp thứ hai, Claude hiểu "tại sao an toàn lại quan trọng" và sẽ có xu hướng thận trọng ngay cả trong các vùng xám.

Lý do cho phép mô hình khái quát hóa; quy tắc chỉ bao quát các kịch bản bạn có thể nghĩ ra. Ngoại lệ duy nhất là định dạng đầu ra: các yêu cầu cơ học như "đầu ra phải sử dụng mẫu này" không có "tại sao" để giải thích, vì vậy hãy mã hóa cứng chúng.

Quyền sở hữu Thông tin: Đừng Lặp lại Chính mình

skill-creator cũng có một quy tắc bất di bất dịch:

"Thông tin chỉ nên tồn tại trong SKILL.md hoặc references — không phải cả hai."

SKILL.md chỉ nên chứa các quy trình cơ bản; di chuyển thông tin chi tiết vào references/. Lưu trữ trùng lặp dẫn đến sự không nhất quán khi bạn cập nhật một nơi nhưng quên nơi kia.

Các Tệp Cần Tránh

Skills dành cho AI, không phải con người. Đừng thêm README.md, INSTALLATION_GUIDE.md, QUICK_REFERENCE.md hoặc CHANGELOG.md. Các tài liệu dành cho con người này chỉ làm lãng phí ngữ cảnh.

4. Xây dựng Skill Đầu tiên của bạn

Sáu Bước Chính thức của Anthropic

Quy trình chuẩn được xác định bên trong skill-creator:

1. Nắm bắt Ý định: Làm rõ việc cần làm / khi nào kích hoạt / định dạng đầu ra / nhu cầu kiểm thử.
2. Phỏng vấn & Nghiên cứu: Các trường hợp ngoại lệ / định dạng đầu vào-đầu ra / tệp mẫu / phụ thuộc.
3. Viết SKILL.md: Viết bản nháp.
4. Viết Ca kiểm thử: Viết 2-3 ca kiểm thử thực tế.
5. Chạy & Đánh giá: Chạy with-skill và baseline (không skill) song song để đối chuẩn.
6. Lặp lại: Sửa đổi dựa trên phản hồi và chạy lại cho đến khi ưng ý.

Bốn Đường tắt cho Người dùng Thông thường

skill-creator: Meta-Skill để Viết Skills

Tôi đặc biệt khuyên bạn nên cài đặt skill-creator chính thức của Anthropic trước. Đây là một Skill được thiết kế để giúp bạn tạo Skill. Sau khi khởi động, Claude sẽ phỏng vấn bạn — hỏi về quy trình làm việc, điều kiện kích hoạt và ranh giới — sau đó tự động tạo ra SKILL.md và cấu trúc thư mục.

Lệnh cài đặt:

[Lệnh]

Nó không chỉ tạo ra đầu ra; nó còn giúp bạn:

• Eval (Đánh giá): Tự động tạo các ca kiểm thử để xác minh Skill có kích hoạt đúng hay không.
• Improve (Cải thiện): Tự động tối ưu hóa mô tả và hướng dẫn dựa trên kết quả kiểm thử, sử dụng phân chia 60/40 train/test để ngăn ngừa overfitting (khớp quá mức).
• Benchmark (Đối chuẩn): Theo dõi tỷ lệ thành công và mức sử dụng token, thậm chí chạy thử nghiệm A/B giữa hai phiên bản.

Một Ví dụ Tối thiểu

Giả sử bạn là một blogger ẩm thực trên Xiaohongshu, muốn viết lại các công thức nấu ăn thông thường theo phong cách Xiaohongshu:

Đặt nó trong ~/.claude/skills/xiaohongshu-recipe/SKILL.md. Trong tương lai, chỉ cần nói "chuyển đổi sang phiên bản Xiaohongshu" là nó sẽ tự động được kích hoạt.

Từ việc tạo tệp đến sử dụng chỉ mất chưa đầy 20 phút.

5. Cài đặt, Lưu trữ và Sử dụng Đa Công cụ

Mức độ Ưu tiên Tải (4 Cấp độ)

Claude Code tìm kiếm theo thứ tự sau; các vị trí cụ thể hơn có mức độ ưu tiên cao hơn:

Mẹo: Trừ khi nó dành riêng cho dự án, hãy giữ chúng trong thư mục cá nhân ~/.claude/skills/ để quản lý tập trung.

Ba Phương pháp Cài đặt:

Nhớ khởi động lại Claude Code sau khi cài đặt.

Tương thích Đa Công cụ (Nhấn mạnh lại)

Như đã đề cập, Skills không bị ràng buộc với Claude. Dưới đây là so sánh đường dẫn:

Ý nghĩa vận hành: Bạn có thể symlink (liên kết tượng trưng) cùng một thư mục SKILL.md tới các thư mục công cụ khác nhau. Đây là lợi ích lớn nhất của Agent Skills như một tiêu chuẩn mở.

Các Vấn đề Đau đầu cho Người dùng Trong nước

• Claude chính hãng đắt đỏ: Sử dụng proxy API để có hiệu suất giá tốt hơn.
• CC Switch: Một công cụ mã nguồn mở để quản lý và chuyển đổi nhiều cấu hình API (github.com/farion1231/cc-switch).
• Cài đặt Native (gốc) ổn định hơn npm: curl -fsSL https://claude.ai/install.sh | bash.

6. Nâng cao — Kiến trúc Cộng tác Đa Skill

Mức độ Chi tiết (Granularity)

Nguyên tắc Cốt lõi: Một nhiệm vụ rõ ràng cho mỗi Skill. Đừng tạo một "Skill vạn năng."

Nếu mức độ chi tiết quá thô, mô tả sẽ không rõ ràng và việc kích hoạt sẽ không chính xác. Nếu quá mịn, chi phí quản lý sẽ tăng lên. Mức độ chi tiết hợp lý là một Skill cho mỗi loại vấn đề, với phần nội dung SKILL.md khoảng 200-500 dòng.

Nghiên cứu điển hình: Bộ Skill Viết Blog

Đừng tạo một "Skill Viết Tất-cả-trong-một." Hãy chia nó thành 5 Skill cộng tác:

Chế độ cộng tác: Skill chính gọi rõ ràng các Skill khác trong phần ## Steps của nó.

Lợi ích của việc chia tách này:

Năm Kinh nghiệm Kỹ thuật

1. Mức độ chi tiết mịn: Một nhiệm vụ rõ ràng cho mỗi Skill.
2. Cộng tác rõ ràng: Sử dụng ## Steps trong Skill chính để gọi các Skill khác.
3. Scripts để tính toán: Sử dụng scripts cho việc đếm ký tự SEO hoặc thống kê liên kết; đừng để mô hình ước tính.
4. Hướng dẫn phong cách độc lập: Đặt kiến thức ổn định (phong cách viết/đặc tả thương hiệu) vào references/ để bạn chỉ thay đổi một tệp là cập nhật phong cách.
5. Dự phòng mẫu (Template fallback): Các mẫu cung cấp một sự đảm bảo cơ bản để đầu ra không quá sai lệch.

7. Đánh giá và Lặp lại Chuyên nghiệp

Hệ thống Eval:

Quy trình chuẩn từ skill-creator:

1. Viết các prompt kiểm thử trong evals/evals.json.
2. Chạy with_skill và baseline (không skill) đồng thời để so sánh mù đôi.
3. Tính điểm cho mỗi khẳng định bằng agents/grader.md.
4. Sử dụng aggregate_benchmark để xuất báo cáo về pass_rate / time / tokens.

Tối ưu hóa Mô tả Tự động

Phần có giá trị nhất của skill-creator là Tối ưu hóa Mô tả:

• Viết 20 truy vấn eval kích hoạt (8-10 nên kích hoạt + 8-10 không nên kích hoạt).
• Khó khăn: "Suýt trượt" cho các truy vấn không kích hoạt — các truy vấn chia sẻ từ khóa nhưng cần các công cụ khác.
• Script tối ưu hóa: 60% train + 40% held-out test để ngăn ngừa overfitting.
• Chạy 5 vòng và chọn mô tả có điểm kiểm thử cao nhất.

Ví dụ tốt về các lệnh kích hoạt: Đừng chỉ viết "trích xuất bảng PDF"; hãy viết như một người dùng thực tế:

"ok ông chủ của tôi vừa gửi cho tôi tệp xlsx này (nó nằm trong mục tải xuống của tôi, có tên gì đó như 'Q4 sales final FINAL v2.xlsx') và bà ấy muốn tôi thêm một cột hiển thị tỷ suất lợi nhuận dưới dạng phần trăm."

Điều này bao gồm đường dẫn tệp, ngữ cảnh cá nhân, tên cột, ngôn ngữ thân mật và các lỗi chính tả tiềm ẩn.

Tư duy Lặp lại

Bốn điểm từ skill-creator:

1. Khái quát hóa từ phản hồi: Đừng thêm các quy tắc vụn vặt cho một trường hợp đơn lẻ. Nếu một vấn đề tái diễn, hãy thử một phép ẩn dụ hoặc quy trình làm việc khác.
2. Giữ cho nó gọn nhẹ: Kiểm tra transcript để tìm các hướng dẫn làm lãng phí thời gian và xóa những phần không giúp ích.
3. Giải thích tại sao: LLM có lý thuyết về tâm trí (theory of mind) và có thể khái quát hóa.
4. Tìm công việc dư thừa: Nếu mọi sub-agent đều đang viết create_docx.py một cách độc lập, hãy gộp nó vào scripts/.

Phiên bản đầu tiên không bao giờ hoàn hảo.

Một trường hợp lặp lại thực tế: Skill /daily của một tác giả đã mất 6 phiên bản để ổn định.

• v1: Các bước không rõ ràng, đường dẫn sai.
• v2: Thêm tích hợp hệ thống khám phá nội dung.
• v3: Sửa lỗi tính toán tiến độ hàng tuần.
• v4: Thêm tự động kích hoạt (nhắc nhở thứ Ba, lưu trữ cuối tháng).
• v5: Thêm chế độ sáng iPhone (bỏ qua các bước Python trên thiết bị di động).
• v6: Cuối cùng "dùng được rồi."

Một Skill không phải là một tệp cấu hình cài đặt rồi quên; nó là một tài liệu sống về quy trình làm việc của bạn.

8. Khi Nào Bạn Nên Tạo Một Skill?

Không phải thứ gì cũng đáng để tạo Skill. Chỉ hành động khi một trong ba tín hiệu này xuất hiện:

Ngược lại: Khi nào KHÔNG nên tạo

• Các tác vụ một lần: Chỉ cần sử dụng prompt.
• Đóng gói quá mức: Chia tách Skills sau khi chỉ sử dụng ba lần; chi phí bảo trì lớn hơn lợi ích.
• Theo đuổi sự hoàn hảo: Cố gắng làm cho v1 hoàn hảo; bạn sẽ thấy các nhu cầu thực ra chỉ là tưởng tượng khi thực sự sử dụng.

9. Danh sách Cạm bẫy

10. Hệ sinh thái và Danh sách "Nên Có"

Bản đồ Tài nguyên Skill

Danh sách Skill "Nên Có"

11. Tiềm năng Thương mại của Skills

Skills không chỉ là công cụ năng suất cá nhân; chúng đang định nghĩa lại cách các ứng dụng AI được sản xuất.

Trước đây, phát triển một ứng dụng AI theo chiều dọc đòi hỏi chu kỳ dài, chi phí cao và đội ngũ kỹ thuật. Bây giờ:

• Ngưỡng không cần code: Xây dựng các Agent theo chiều dọc mà không cần viết code.
• Xác nhận nhanh chóng: Chu kỳ phát triển được rút ngắn từ vài tuần xuống còn vài phút.
• Dịch vụ API: Đóng gói một Skill dưới dạng API để hỗ trợ các sản phẩm hiện có.
• Skills như sản phẩm: Tương tự như bán bộ sưu tập prompt, nhưng có giá trị cao hơn.

Các trường hợp thực tế:

• Article-Copilot: Một Skill duy nhất cho toàn bộ chuỗi từ làm sạch tài liệu đến viết lách.
• AI Partner Skill: Cung cấp cho các Agent đa năng trí nhớ sâu để trở thành người bạn đồng hành thực sự.
• Skill Chuẩn bị Phỏng vấn: Tạo báo cáo đầy đủ dựa trên công ty/công việc/sơ yếu lý lịch. Ai đó đã sử dụng nó để có được buổi phỏng vấn tại Hithink RoyalFlush.
• Phương pháp của Super Huang: Hàng chục Skills + cron jobs chạy các báo cáo hàng giờ trong khi anh ấy ngủ.

Bất kỳ ai có chuyên môn sâu trong một ngành đều có thể chưng cất kinh nghiệm của mình thành một Skill để tiết kiệm thời gian hoặc bán nó như một sản phẩm.

Kết luận

Nếu Agent là cơ thể của thế giới AI, thì Skill là linh hồn được truyền vào nó.

Nó giống như mối quan hệ giữa Steam và Workshop; kiến trúc có thể mở rộng mang lại cho trò chơi sức sống vô tận.

Skills không khó — chúng chỉ là Markdown với một số cấu trúc. Nhưng xu hướng mà chúng đại diện là rất quan trọng: AI chuyển từ "bạn phải dạy nó mỗi lần" sang "bạn chỉ dạy nó một lần."

Và tiêu chuẩn là mở. Skill bạn viết cho Claude Code hôm nay có thể được chuyển sang Cursor hoặc Gemini vào ngày mai.

Gửi tới những người vẫn còn đang dõi theo:

Skills không được thiết kế; chúng phát triển từ lao động lặp đi lặp lại.

Hãy chạy một thứ trước, sau đó đóng gói nó. Các quy trình làm việc tốt được lặp lại, không phải được lên kế hoạch.

Mở terminal của bạn, cài đặt skill-creator, và biến đoạn văn mà bạn đã lặp lại ba lần hôm nay thành SKILL.md đầu tiên của bạn.