Tài liệu Agent Skills

Skill

SkillTài liệuĐộ khó: Trung bìnhMiễn phí

Tài liệu Agent Skills

4.0/5Đánh giá của 2dm

Cần đọc khi tự viết skill; nội dung khá kỹ thuật.

Giải thích skill là gì, cấu trúc thư mục SKILL.md và cách Claude tự nạp skill khi cần.

Mở trang chính thức Xem cách dùng

Giới thiệu

Đây là trang tài liệu chính thức của Anthropic giải thích Agent Skills: các năng lực dạng mô-đun giúp Claude làm tốt việc chuyên môn. Mỗi skill đóng gói hướng dẫn, metadata và tài nguyên tùy chọn như script hay template, và Claude tự dùng khi yêu cầu của bạn khớp.

Trang mô tả cơ chế "tiết lộ dần" (progressive disclosure) gồm ba tầng: metadata luôn được nạp, phần hướng dẫn chỉ nạp khi skill được kích hoạt, còn file tham khảo và script chỉ được đọc hoặc chạy khi cần. Nhờ vậy có thể cài nhiều skill mà không tốn ngữ cảnh.

Tài liệu cũng nêu rõ skill hoạt động ở đâu (Claude API, Claude Code, Claude.ai), giới hạn của từng nền tảng và các lưu ý bảo mật. Đây là trang nên đọc đầu tiên trước khi doanh nghiệp quyết định đưa skill vào quy trình.

Tính năng nổi bật

Tải theo nhu cầu

Khi chưa dùng, mỗi skill chỉ chiếm khoảng 100 token cho tên và mô tả; phần hướng dẫn chỉ vào ngữ cảnh khi được kích hoạt.

Script chạy ngoài ngữ cảnh

Claude chạy script qua bash và chỉ nhận kết quả đầu ra, nên xử lý ổn định và tiết kiệm token.

Skill dựng sẵn cho văn phòng

Có sẵn skill PowerPoint, Excel, Word và PDF trên Claude API và Claude.ai.

Quy định rõ cho SKILL.md

name tối đa 64 ký tự, chỉ chữ thường, số và gạch nối; description không rỗng và tối đa 1024 ký tự.

Mỗi nền tảng một cách chia sẻ

Claude.ai chỉ dùng cá nhân, API dùng chung toàn workspace, Claude Code theo cá nhân hoặc theo dự án.

Dùng để làm gì

Tạo báo cáo tự động qua API

Đội dev gọi Claude API kèm skill xlsx hoặc pptx để sinh báo cáo, slide từ dữ liệu nội bộ.

Chuẩn hóa quy trình phòng ban

Đóng gói quy trình như soạn hợp đồng mẫu hay kiểm tra hồ sơ thành skill để Claude làm theo một cách nhất quán.

Đánh giá rủi ro trước khi triển khai

Bộ phận IT dùng phần bảo mật trong tài liệu làm checklist kiểm duyệt skill bên ngoài.

Lựa chọn nền tảng phù hợp

Quản lý so sánh giới hạn mạng và phạm vi chia sẻ để chọn dùng skill trên Claude.ai, API hay Claude Code.

Cách dùng

1
Nắm khái niệm
Đọc phần giải thích skill là gì và ba tầng nạp nội dung để hiểu cách Claude dùng skill.
2
Chọn nền tảng
Xác định bạn sẽ dùng skill trên Claude API, Claude Code hay Claude.ai, vì mỗi nơi có giới hạn khác nhau.
3
Viết SKILL.md
Tạo file có frontmatter YAML với name và description, bên dưới là hướng dẫn từng bước và ví dụ.
4
Đưa skill vào môi trường
Claude Code đặt skill trong ~/.claude/skills/ hoặc .claude/skills/; Claude.ai tải file zip trong Settings > Features; API tải qua các endpoint /v1/skills.
5
Kiểm duyệt bảo mật
Rà soát toàn bộ file trong skill, đặc biệt script và chỗ gọi ra mạng ngoài, trước khi dùng thật.

Video hướng dẫn

The Only Claude Skills Guide You Need (Beginner to Expert)
Kenny Liao

Anthropic Agent Skills Explained: Build Specialized Claude Agents (Complete Tutorial)
Prompt Circle AI

Ví dụ thực tế

Tình huống minh hoạ

Giả sử một chuỗi cửa hàng nội thất có đội dev 3 người muốn tự động tạo slide báo cáo doanh số hằng tháng. Nhóm đọc tài liệu Agent Skills, nhận ra trên Claude API skill chạy trong container không có mạng, nên quyết định đưa sẵn dữ liệu vào yêu cầu thay vì để skill tự gọi API ngoài. Họ dùng skill pptx dựng sẵn để tạo slide, đồng thời viết một skill riêng mô tả bố cục, màu sắc và cách đặt tên file theo chuẩn công ty, rồi tải lên workspace để cả nhóm cùng dùng.

Mẹo & lưu ý

Description quyết định tất cả
Claude so yêu cầu với description để chọn skill, nên ghi rõ skill làm gì và khi nào dùng.
Skill không tự đồng bộ
Skill tải lên Claude.ai không có trên API và ngược lại; Claude Code dùng thư mục riêng, phải quản lý từng nơi.
Coi skill như phần mềm
Chỉ dùng skill do bạn tự viết hoặc từ Anthropic; skill lạ phải được kiểm tra kỹ vì có thể dẫn tới rò rỉ dữ liệu.
Tách file tham khảo
Đưa tài liệu dài vào file riêng; Claude chỉ đọc khi cần nên không tốn token nếu không dùng.