# Agent Skills (SKILL.md)

> VI: https://5ac.vn/wiki/agent-skills/ · EN: https://5ac.vn/en/wiki/agent-skills/ · lang: vi · spec_as_of 2026-10-18 (spec unversioned) · cluster C3

Thư mục quanh một tệp SKILL.md mà agent tải dần qua ba giai đoạn khám phá, kích hoạt và thực thi, dùng để bổ sung chuyên môn chuyên biệt.

---
## Định nghĩa

Agent Skills là định dạng mở để nạp chuyên môn cho agent dưới dạng thư mục quanh một tệp SKILL.md: frontmatter khai name và description, phần thân viết hướng dẫn, kèm script hay tài nguyên tham khảo. Agent chỉ đọc mô tả lúc khởi động, rồi nạp hướng dẫn đầy đủ khi task thật sự trùng khớp.

## Cơ chế

Skill hoạt động theo nguyên tắc progressive disclosure (tải dần): chi tiết chỉ vào cửa sổ ngữ cảnh khi task thật sự cần, nên gắn nhiều skill cùng lúc vẫn nhẹ.

| Giai đoạn | Agent nạp gì | Chi phí ngữ cảnh |
| --- | --- | --- |
| Khám phá | name và description của mọi skill lúc khởi động | khoảng 100 token mỗi skill |
| Kích hoạt | toàn bộ thân SKILL.md khi mô tả khớp task | đề xuất dưới 5.000 token |
| Thực thi | script, references, assets theo yêu cầu | chỉ khi task cần |

Luồng: Khám phá → Kích hoạt → Thực thi

Hai trường bắt buộc giữ kỷ luật metadata: name giới hạn 64 ký tự, chỉ chữ thường, số và dấu gạch, đồng thời phải trùng tên thư mục chứa nó; description dài 1 đến 1024 ký tự, nêu rõ skill làm gì lẫn khi nào dùng. Thân tệp là Markdown tự do, nhưng spec khuyên giữ SKILL.md dưới 500 dòng rồi tách tài liệu dài sang references/, vì agent nạp trọn tệp mỗi lần kích hoạt.

Thư mục skill có thể kèm scripts/, references/, assets/. Khi dẫn file trong hướng dẫn, dùng đường dẫn tương đối và chỉ trỏ một cấp từ SKILL.md; chuẩn còn cung cấp lệnh skills-ref validate để kiểm tra frontmatter trước khi đưa skill vào dùng.

Ngoài hai trường bắt buộc, frontmatter có thêm compatibility để ghi yêu cầu môi trường như Python hay docker, license cho tên license hoặc tệp kèm theo, và metadata dạng map key–value để công cụ lưu thông tin ngoài chuẩn.

## Neo chuẩn (spec anchor)

Chuẩn normative là [agentskills.io/specification](https://agentskills.io/specification); trang này không xưng một phiên bản nào, nên frontmatter ghi "unversioned" và neo theo ngày đối chiếu 18/10/2026 thay vì đoán số phiên bản. Định dạng do Anthropic phát triển rồi mở cho hệ sinh thái, và [github.com/anthropics/skills](https://github.com/anthropics/skills) giữ bản triển khai tham chiếu kèm thư mục spec/ và template/.

## Neo học thuật

Chưa có paper arXiv nào về chuẩn Agent Skills được kiểm chứng tại thời điểm viết, nên phần học thuật neo bằng số đo lấy trực tiếp trong ngày:

| Nguồn | Số liệu | Ngày đo |
| --- | --- | --- |
| [github.com/anthropics/skills](https://github.com/anthropics/skills) | khoảng 181.800 sao (thời điểm truy xuất 2026-10-18), repository tạo ngày 22/09/2025, có sẵn spec/ và template/ | 18/10/2026 |
| [agentskills.io](https://agentskills.io/) | client hỗ trợ gồm Claude Code, Cursor, GitHub Copilot, VS Code, ChatGPT & Codex, OpenHands, Goose, Gemini CLI | 18/10/2026 |

## Câu hỏi thường gặp

**SKILL.md khác prompt thông thường ở đâu?** Prompt là câu lệnh gửi kèm mỗi lượt; skill nằm sẵn trong dự án, agent tự biết khi nào cần nạp nhờ name và description, và hướng dẫn không mất đi sau mỗi lần reset ngữ cảnh.

**Skill có tự chạy script không?** Có, khi thân skill hướng dẫn chạy script kèm theo; frontmatter có thêm allowed-tools để liệt kê trước công cụ được phép dùng, nhưng trường này còn experimental nên hỗ trợ lệch nhau giữa các công cụ.

**Gắn nhiều skill thì tốn context bao nhiêu?** Lúc khởi động mỗi skill chỉ tốn khoảng 100 token metadata; hướng dẫn đầy đủ mới vào context khi kích hoạt, nên giữ hàng chục skill trong dự án vẫn nhẹ.

**Dùng được với công cụ nào?** [agentskills.io](https://agentskills.io/) liệt kê Claude Code, Claude, ChatGPT & Codex, Cursor, GitHub Copilot, VS Code, OpenHands, Goose, Amp, Gemini CLI, OpenCode, Factory và nhiều client khác.

**Kho skill mẫu có open source không?** Trong repository, nhiều skill dùng giấy phép Apache 2.0; bộ skill tạo tài liệu (docx, pdf, pptx, xlsx) chỉ source-available chứ không open source, và README ghi rõ các skill này dùng để minh hoạ, hành vi thật trên Claude có thể khác.

Skill chỉ đáng đóng gói khi hướng dẫn tái sử dụng được; chỉ dẫn dùng một lần chỉ thêm nặng phần metadata.

**Những nguồn nào dựng nên entry này?** Ba trang chính, cùng truy cập ngày 18/10/2026: [agentskills.io/specification](https://agentskills.io/specification) cho định dạng SKILL.md, [agentskills.io](https://agentskills.io/) cho mô tả chuẩn và ba giai đoạn nạp, [github.com/anthropics/skills](https://github.com/anthropics/skills) cho bản triển khai của Anthropic.

## Liên quan

- [AGENTS.md](/wiki/agents-md/)
- [Hệ thống điều hành multi-agent là gì?](/blog/he-thong-dieu-hanh-multi-agent-la-gi/)
- [4 kỹ năng AI engineering theo Andrew Ng](/blog/ky-nang-ai-engineering-4-kien-thuc/)