Agent Skills là gì? Hiểu đúng SKILL.md trước khi cài hàng chục skill
Tóm tắt
Agent Skill là một thư mục chứa file SKILL.md (tên + mô tả + hướng dẫn) và có thể kèm script, tài liệu tham khảo. Agent chỉ nạp tên và mô tả lúc khởi động, khi gặp việc phù hợp mới đọc toàn bộ hướng dẫn — nhờ vậy cài nhiều skill mà không tốn nhiều context.
Cấu trúc một skill
my-skill/
├── SKILL.md # frontmatter: name, description + hướng dẫn
├── scripts/ # (tuỳ chọn) code chạy được
├── references/ # (tuỳ chọn) tài liệu đọc khi cần
└── assets/ # (tuỳ chọn) template, ảnh…Vì sao skill khác prompt dài?
| Đặc điểm | Ý nghĩa |
|---|---|
| Progressive disclosure | Lúc khởi động agent chỉ đọc tên + mô tả (vài chục token mỗi skill); hướng dẫn đầy đủ chỉ nạp khi cần. |
| Chuẩn mở | Anthropic công bố Agent Skills thành chuẩn mở cuối năm 2025 (agentskills.io); nhiều công cụ đã hỗ trợ. |
| Cài nhanh | npx skills add <owner/repo>, hoặc chép thư mục vào ~/.claude/skills/. |
Áp dụng thế nào?
- Viết mô tả thật rõ: agent quyết định dùng skill dựa vào
description— mô tả mơ hồ thì skill sẽ không bao giờ được gọi. - Mỗi skill một việc: “viết release note”, “review PR theo checklist team” tốt hơn một skill “làm mọi thứ”.
- Đọc kỹ trước khi cài: skill có thể chạy script và ghi file. Với skill có tác động thật (deploy, gửi dữ liệu ra ngoài), đặt
disable-model-invocation: trueđể chỉ chạy khi bạn gọi. - PM / Tech Lead: gói quy trình của team (Definition of Done, template báo cáo) thành skill dùng chung trong repo.
Tham khảo: Giới thiệu Agent Skills (Firecrawl)