Bài 02Phần 1 · Nền tảng

Lập kế hoạch Skill
3 danh mục và quy tắc vàng

Lập kế hoạch xây dựng skill Claude AI: mọi skill thực chiến đều rơi vào một trong ba nhóm. Xác định đúng nhóm giúp định hình kiến trúc thư mục ngay từ đầu.

🎯 Mục tiêu bài học

Xác định skill của bạn thuộc danh mục nào trong ba nhóm thực chiến.
Áp dụng quy tắc vàng: định nghĩa use case trước khi viết dòng đầu tiên.
Xây ma trận đo lường thành công gồm cả chỉ số định lượng và định tính.
Áp dụng quy trình phát triển dựa trên đánh giá (eval-driven) do Anthropic khuyến nghị.

BA DANH MỤC

Mọi skill thực chiến đều rơi vào một trong ba nhóm này

Document Creation — sinh tài liệu chuẩn

Nhúng style guide và brand standard vào skill để mọi tài liệu ra lò đều nhất quán về định dạng.
Kiến trúc: nặng về references/ và assets/.
Ví dụ: bao-cao-tuan-chuan, de-xuat-du-an.

Workflow Automation — tự động hoá quy trình

Nhúng checklist và cấu trúc template để rút ngắn các tác vụ lặp đi lặp lại.
Kiến trúc: nặng về quy trình từng bước trong SKILL.md và scripts/ kiểm tra.
Ví dụ: quy-trinh-onboard.

MCP Enhancement — nâng cấp công cụ

Cung cấp chuyên môn ngành cho MCP đã có, tối ưu các chuỗi gọi API phức tạp.
Kiến trúc: nặng về logic ra quyết định và tên tool đầy đủ.
Ví dụ: bao-cao-ads-tu-dong.

QUY TẮC VÀNG

Định nghĩa use case trước — KHÔNG viết code cho tới khi xong 3 bước này

1Trigger Phrase — người dùng nói gì thì skill phải thức dậy?

2Core Steps — skill làm những bước cốt lõi nào?

3Expected Result — kết quả đầu ra trông chính xác như thế nào?

⛔ Lý do quy tắc này quan trọng

Nếu chưa trả lời được ba câu hỏi trên, bạn đang viết tài liệu cho một vấn đề tưởng tượng. Tài liệu chính thức của Anthropic gọi đây là "giải quyết vấn đề thật thay vì tài liệu hoá vấn đề trong đầu" — và khuyên xây bộ đánh giá TRƯỚC khi viết hướng dẫn dài.

ĐO LƯỜNG

Ma trận tiêu chí thành công — định lượng và định tính

Nhóm chỉ số	Định lượng (đo được bằng số)	Định tính (cảm nhận người dùng)
Kích hoạt	Tỷ lệ trigger đạt trên 90% với 5 cách diễn đạt khác nhau	Người dùng không phải nhắc lại ngữ cảnh
Hiệu quả	Tiết kiệm ít nhất 40% token so với gõ prompt tay	Kết quả nhất quán qua nhiều phiên làm việc
Độ tin cậy	0 lần gọi API hoặc script thất bại	Giảm rõ rệt việc phải can thiệp sửa tay
Thời gian	Rút ngắn tác vụ từ 2 giờ xuống dưới 10 phút	Sản phẩm dùng được ngay, không phải làm lại

QUY TRÌNH ANTHROPIC KHUYẾN NGHỊ

Phát triển skill dựa trên đánh giá — 5 bước

1. Xác định lỗ hổng

Cho Claude làm tác vụ đại diện khi chưa có skill. Ghi lại chính xác chỗ nào Claude thất bại hoặc thiếu ngữ cảnh. Đây là danh sách vấn đề thật.

2. Tạo bộ đánh giá

Dựng tối thiểu 3 kịch bản kiểm tra đúng những lỗ hổng đó. Mỗi kịch bản ghi rõ câu lệnh, file đầu vào và hành vi mong đợi.

3. Đo mốc chuẩn

Chạy các kịch bản không có skill, ghi lại kết quả. Đây là baseline để so sánh — không có nó bạn không biết skill có cải thiện thật hay không.

4. Viết hướng dẫn tối thiểu

Viết vừa đủ để vượt qua bộ đánh giá, không hơn. Mọi đoạn thừa đều là chi phí token vĩnh viễn cho mọi lần skill được kích hoạt.

5. Lặp lại

Chạy lại bộ đánh giá, so với baseline, tinh chỉnh. Chỉ mở rộng skill khi có bằng chứng rằng phần mở rộng đó giải quyết một thất bại có thật.

MẪU KỊCH BẢN ĐÁNH GIÁ

Cấu trúc một eval — dùng JSON cho dễ chấm

{
  "skills": ["bao-cao-tuan-chuan"],
  "query": "Làm báo cáo tuần từ file KPI này",
  "files": ["test-files/kpi-tuan-32.xlsx"],
  "expected_behavior": [
    "Đọc được file Excel và lấy đúng cột doanh thu, chi phí, tỷ lệ chuyển đổi",
    "Xuất báo cáo theo khung BLUF: kết luận trước, dữ liệu sau",
    "Có đủ 5 mục bắt buộc và không bịa số liệu không có trong file"
  ]
}

🎯

Mẹo chọn skill đầu tiênĐừng chọn tác vụ hoành tráng nhất. Hãy chọn tác vụ bạn lặp lại nhiều nhất trong tuần này và đã có sẵn tiêu chuẩn đầu ra rõ ràng. Skill đầu tiên nên ship được trong 30 phút — kinh nghiệm từ nó sẽ định hình cách bạn xây những skill khó hơn.

CÂU HỎI THƯỜNG GẶP

FAQ — 3 câu hỏi thường gặp về lập kế hoạch xây dựng skill claude ai

Ba danh mục skill phổ biến là gì?

Document Creation (sinh tài liệu chuẩn — nặng về references/ và assets/), Workflow Automation (tự động hoá quy trình — nặng về các bước và scripts/), MCP Enhancement (nâng cấp công cụ — nặng về logic ra quyết định).

Quy tắc vàng trước khi viết skill là gì?

Chốt xong ba thứ trước khi viết dòng code nào: Trigger Phrase (người dùng nói gì thì skill thức dậy), Core Steps (skill làm những bước nào), Expected Result (kết quả đầu ra trông thế nào). Chưa trả lời được là bạn đang viết tài liệu cho một vấn đề tưởng tượng.

Nên chọn skill đầu tiên như thế nào?

Không chọn tác vụ hoành tráng nhất mà chọn tác vụ bạn lặp lại nhiều nhất trong tuần này và đã có tiêu chuẩn đầu ra rõ ràng. Skill đầu tiên nên ship được trong 30 phút.

Nguồn: Bài viết biên soạn dựa trên tài liệu Xây dựng bộ Skills cho Claude (Anthropic Academy, bản tiếng Việt do Nguyen Ngoc Tuan trình bày), đã viết lại và đối chiếu với tài liệu Agent Skills chính thức của Anthropic (platform.claude.com và code.claude.com), cập nhật 15/08/2026. Mọi số liệu kỹ thuật lấy theo tài liệu chính thức.