Agent Skills

Agent Skills là các thư mục chứa chỉ dẫn, script và tệp tham khảo, cung cấp cho AI agent chuyên môn về một loại tác vụ cụ thể; chúng được đóng gói để agent chỉ tải khi tác vụ cần đến. Mỗi kỹ năng tập trung vào một tệp SKILL.md có phần mô tả ngắn cho agent biết khi nào nên sử dụng, còn nội dung chính giải thích cách thực hiện. Anthropic giới thiệu Agent Skills cho Claude vào tháng 10 năm 2025 và công bố định dạng này thành tiêu chuẩn mở tại agentskills.io vào tháng 12 năm 2025. Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, VS Code và hàng chục agent khác hiện đọc cùng các thư mục đó, nên một kỹ năng có thể hoạt động trên tất cả.

Cách Agent Skills hoạt động#

Một kỹ năng là thư mục mang tên kỹ năng, chứa một SKILL.md bắt buộc cùng các thư mục scripts/, references/ và assets/ tùy chọn. SKILL.md bắt đầu bằng phần frontmatter YAML gồm hai trường bắt buộc: name dài tối đa 64 ký tự viết thường, chữ số và dấu gạch nối, khớp với tên thư mục; và description dài tối đa 1.024 ký tự, nêu rõ kỹ năng làm gì và khi nào nên dùng. Phần nội dung Markdown tiếp theo chứa quy trình, ví dụ và các trường hợp biên.

Agent tải kỹ năng theo cơ chế tiết lộ tăng dần, giúp thư viện kỹ năng lớn không gây tốn kém. Khi khởi động, agent chỉ đọc tên và mô tả của mỗi kỹ năng, khoảng 100 token cho mỗi kỹ năng. Khi yêu cầu khớp với mô tả, agent đọc toàn bộ SKILL.md vào cửa sổ ngữ cảnh; đặc tả khuyến nghị giữ phần nội dung này dưới 500 dòng và 5.000 token. Script và tệp tham khảo chỉ được tải khi chỉ dẫn yêu cầu; code của script hoàn toàn không đi vào ngữ cảnh nếu agent chỉ chạy script rồi đọc đầu ra.

Cấu trúc của SKILL.md#

Một nhóm bán lẻ có thể cung cấp cho agent kỹ năng này để xử lý ảnh kệ hàng. Mô tả chứa các từ khóa kích hoạt mà agent đối chiếu, còn phần nội dung trỏ đến một script và bảng tham khảo chỉ được tải khi cần:

---
name: shelf-audit
description: Counts products and finds empty facings in retail shelf photos. Use when the user asks about stock levels, gaps, or planogram compliance in store images.
---

# Shelf audit

1. Run `python scripts/detect_products.py <image>` on each photo. It prints one JSON line per product with its class, confidence, and box.
2. Compare the counts with the expected facings in `references/planogram.csv`.
3. Report each empty facing with its shelf position.
4. Send detections below 0.5 confidence to a person for review instead of counting them.

Agent chỉ thấy hai dòng frontmatter cho đến khi có người hỏi về kệ hàng; agent chỉ mở tệp sơ đồ bố trí hàng ở bước 2.

Agent Skills và các khái niệm liên quan#

• Công cụ và gọi hàm: Công cụ là một thao tác mà agent có thể gọi, chẳng hạn truy vấn cơ sở dữ liệu hoặc model phát hiện đối tượng. Kỹ năng dạy agent khi nào và cách kết hợp các công cụ để thực hiện một tác vụ, cùng với quy tắc xác thực và ngữ cảnh lĩnh vực mà bản thân công cụ còn thiếu.
• Model Context Protocol (MCP): Kết nối agent với các hệ thống bên ngoài đang hoạt động thông qua máy chủ. Kỹ năng cung cấp kiến thức về quy trình, nên agent thường dùng cả hai: kỹ năng có thể chỉ cho agent biết cần gọi những công cụ MCP nào và theo thứ tự nào.
• System prompt và chỉ dẫn dự án: Các tệp như AGENTS.md được tải vào mọi phiên. Nội dung kỹ năng chỉ được tải cho những tác vụ phù hợp, nên agent có thể mang theo hàng trăm kỹ năng mà không làm chật ngữ cảnh — đây là ý tưởng cốt lõi của kỹ thuật ngữ cảnh.
• Tinh chỉnh: Thay đổi trọng số của model để dạy model cách hoạt động. Skill chỉ thay đổi ngữ cảnh, vì vậy có thể chỉnh sửa, tạo phiên bản và rà soát như mã nguồn, đồng thời có hiệu lực ngay lập tức.

Ứng dụng Skills trong thực tế#

Skills đóng gói kiến thức chuyên môn mà mô hình ngôn ngữ lớn (LLM) tổng quát còn thiếu hoặc áp dụng không nhất quán: quy tắc thương hiệu của công ty, checklist phát hành của một nhóm hoặc những điểm đặc thù của một định dạng tệp. Kho skills công khai của Anthropic có các skill Word, PDF, PowerPoint và Excel hỗ trợ Claude tự tạo tài liệu. Agent Skills của Ultralytics bao quát toàn bộ vòng đời thị giác máy tính: skill định tuyến yolo chuyển từng yêu cầu đến skill phù hợp để chọn model, xử lý dataset, huấn luyện, tinh chỉnh, suy luận hoặc xuất model; còn skill platform-cli tự động hóa Ultralytics Platform bằng dòng lệnh ul cloud. Trợ lý Ask AI của Platform cũng sử dụng skill platform-cli đó, và có thể cài đặt cùng các thư mục này trong Claude Code bằng claude plugin install yolo@ultralytics hoặc trong các agent khác bằng npx skills add ultralytics/skills, nhờ đó một công cụ lập trình theo hướng agent có thể huấn luyện và xuất model YOLO26 từ một yêu cầu bằng ngôn ngữ tự nhiên.

Các cân nhắc về bảo mật#

Skill chạy với quyền của agent, vì vậy cài đặt skill của bên thứ ba cũng giống như cài đặt phần mềm. Chỉ dẫn của skill có thể chứa nội dung chèn prompt nhằm chuyển hướng agent, còn script của skill có thể đọc tệp hoặc gửi dữ liệu đến bất kỳ nơi nào mà môi trường của agent cho phép. Các nhóm rà soát chỉ dẫn, script và dependency của skill trước khi cài đặt, cố định phiên bản và chạy script trong sandbox của agent với quyền truy cập mạng hạn chế. Đặc tả cũng định nghĩa trường thử nghiệm allowed-tools, là danh sách phân tách bằng dấu cách, chẳng hạn Bash(git:*) Read, nêu tên các công cụ mà skill có thể chạy mà không cần hỏi; các agent hỗ trợ trường này sẽ phê duyệt trước những công cụ đó trong môi trường điều phối agent của mình.