Đi hết bảy bước dưới đây, bạn sẽ có một Agent Skill hoàn chỉnh, tự động hóa được những quy trình chuyên biệt như xử lý văn bản hay phân tích dữ liệu trên nền tảng Claude.
Tạo Agent Skill cho phép bạn đóng gói kiến thức chuyên môn thành các khả năng mô-đun, biến Claude thành một chuyên gia thay vì một mô hình ngôn ngữ chung.
Yêu cầu tiên quyết: máy đã cài Claude Code hoặc có quyền truy cập Claude API. Bạn cũng cần nắm cấu trúc thư mục hệ thống và cách tổ chức tệp cơ bản.
Bước 1 — Chọn việc lặp lại đáng đóng gói thành Skill
Phân tích các tác vụ lặp lại định kỳ: danh sách kiểm tra, quy trình thực thi nhiều bước, hoặc các
đoạn hướng dẫn thường xuyên phải copy-paste vào hội thoại. Rà soát tệp
CLAUDE.md hiện có; nếu tệp này
quá dài hoặc chứa nhiều hướng dẫn quy trình thay vì các dữ kiện, hãy tách chúng ra thành các Skill
riêng biệt. Đó chính là cơ chế "Tiết lộ lũy tiến" (Progressive Disclosure): chỉ tải nội dung khi cần
để tiết kiệm token.
Bước 2 — Viết eval trước khi viết hướng dẫn
Thiết lập bộ khung kiểm thử (evaluation) trước khi viết code. Quan sát Claude tự làm tác vụ đó khi chưa có Skill để xác định các điểm yếu, lỗi logic hoặc những bước hay bị bỏ sót. Xây dựng kịch bản kiểm thử gồm:
- Prompt đầu vào: câu lệnh thực tế từ người dùng.
- Tệp dữ liệu mẫu: tệp liên quan (PDF, CSV, mã nguồn).
- Kết quả kỳ vọng: tiêu chuẩn đánh giá thành công để so sánh sau khi áp dụng Skill.
Bước 3 — Tạo khung skill trong thư mục skills
Dùng CLI để khởi tạo cấu trúc thư mục cho Skill. Chọn đường dẫn dựa trên phạm vi sử dụng:
- Cá nhân:
mkdir -p ~/.claude/skills/pdf-processing— áp dụng cho mọi dự án của bạn. - Dự án:
mkdir -p .claude/skills/pdf-processing— chỉ dành riêng cho repository hiện tại.
Bên trong thư mục này, tạo tệp SKILL.md. Đây là tệp cấu hình bắt buộc để hệ thống nhận diện Skill.