# Hướng dẫn tạo Agent Skill từng bước

> Bảy bước tạo một Agent Skill hoàn chỉnh: đóng gói kiến thức chuyên môn thành mô-đun, tối ưu quy trình tự động hóa và tiết kiệm token trên nền tảng Claude.

Nguồn: https://camnangai.com/cong-cu/huong-dan-tao-agent-skill  
Xuất bản: 2026-08-02

Đi hết bảy bước dưới đây, bạn sẽ có một [Agent Skill](https://camnangai.com/kien-thuc-ai/agent-skills-la-gi) 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.

![Thư mục .claude/skills/ mở trong trình soạn thảo, bên trong là tệp SKILL.md của một Agent Skill](https://camnangai.com/articles/huong-dan-tao-agent-skill/01-infographic.webp)

## 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`](https://camnangai.com/ung-dung-ai/lap-trinh-vien/claude-md-vs-agents-md-vs-skill-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.

![Vòng lặp viết eval trước: chạy tác vụ khi chưa có Skill để lấy mốc, viết Skill, chạy lại rồi đối chiếu với mốc ban đầu](https://camnangai.com/articles/huong-dan-tao-agent-skill/02-vn.webp)

## 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.

_Phần còn lại của bài viết dành cho thành viên. Đọc toàn bộ tại https://camnangai.com/cong-cu/huong-dan-tao-agent-skill_