Cùng model Claude Haiku, cùng một yêu cầu báo giá: skill viết kiểu cũ báo thiếu hơn 20 triệu đồng, còn skill viết lại theo hướng dẫn mới của Anthropic thì đúng tới từng đồng. Bài này đi qua 10 quy tắc viết skill Claude mà Anthropic vừa cập nhật cho các model mới, mỗi quy tắc kèm câu gốc trong tài liệu và một ví dụ chạy thật. Đọc xong, bạn biết cách viết skill ngắn hơn, tốn ít token hơn và không để lọt luật quan trọng nhất.
Nếu bạn chưa có skill nào, đây là cách viết đúng ngay từ đầu. Nếu đã có rồi, khả năng cao skill của bạn đang tốn token hơn mức cần, hoặc thiếu đúng cái luật quan trọng nhất. Bản video đầy đủ, có demo từng quy tắc: xem video trên YouTube.
Skill Claude là gì và vì sao cách viết skill quyết định số token bạn trả?
Mỗi lần nhờ AI làm một việc lặp lại, bạn thường phải gõ một prompt dài: bạn là ai, khách hàng là ai, giá sản phẩm bao nhiêu, cái gì tuyệt đối không được làm. Lần sau lại gõ lại y hệt từ đầu.
Skill là bạn viết những thứ đó một lần, vào một file văn bản tên SKILL.md. Lần sau chỉ cần nói “làm báo giá cho khách này”, Claude tự mở skill ra và làm đúng quy trình. Skill không phải code. Nó là tiếng Việt bình thường, có các bước, có checklist. Bộ GiangXAI Lab của mình cũng được xây theo đúng cách này: Agent chỉ là workflow cộng với skill, viết bằng ngôn ngữ tự nhiên.
Để thấy rõ từng quy tắc, mình dựng một skill làm báo giá cho Mộc Studio, một studio thiết kế giả định, rồi viết hai phiên bản:
- Bản cũ: viết “kiểu quen tay”, 542 dòng, cố ý mắc đủ 10 lỗi.
- Bản mới: cùng dữ liệu, viết lại theo 10 quy tắc, còn 53 dòng kèm vài file tham chiếu, script tính tiền và một hook.
Bài kiểm tra chung cho cả hai: khách mới “Nhà hàng Lửa” cần website bán hàng và 30 bài đăng, bàn giao trong 5 ngày. Đáp án đúng là 90.090.000₫, cọc 50% là 45.045.000₫, và báo giá phải chờ chủ studio duyệt trước khi gửi.
Quy tắc 1–2: Viết skill Claude ngắn, chia nhỏ để tiết kiệm token
Quy tắc 1: Chia nhỏ, chỉ sâu một tầng
Anthropic khuyên giữ phần thân SKILL.md dưới 500 dòng (“Keep SKILL.md body under 500 lines for optimal performance”). Phần chi tiết tách ra file riêng, còn file chính chỉ như trang mục lục. Claude chỉ mở file con khi bước đang làm thật sự cần.
Nhưng có một cái bẫy: file chính trỏ tới file A, file A lại trỏ tiếp file B. Với file B, Claude có thể chỉ xem trước khoảng 100 dòng đầu thay vì đọc hết, nên thông tin bị thiếu. Vì vậy mọi file con phải được link thẳng từ file chính, chỉ sâu một tầng.
Trong skill báo giá bản cũ, quy tắc giảm giá và phụ phí làm gấp nằm ở file thứ ba, sau dòng 117. Bản mới chỉ còn file chính 53 dòng, bảng giá tách riêng và link thẳng từ file chính. Kết quả: lượng chữ Claude phải đọc cho một báo giá giảm từ 49.944 xuống 7.311 ký tự, tức giảm khoảng 85%. Đây là cách tiết kiệm token rõ nhất: Claude đọc ít hơn mà vẫn đủ thông tin cần cho từng bước. Quan trọng hơn, luật không còn nằm ở chỗ Claude có thể không đọc tới.
Quy tắc 2: Đặt mục lục ở đầu file dài
File tham chiếu nào dài hơn 100 dòng thì đặt mục lục ở đầu. Kể cả khi chỉ đọc lướt phần đầu, Claude vẫn biết bên dưới có gì để nhảy tới đúng chỗ.
File giảm giá cũ dài 123 dòng, không có mục lục, quy tắc thật nằm tận cuối. Bảng giá mới mở đầu bằng mục lục, dòng cuối ghi rõ: quy tắc giảm giá, phụ phí, VAT.
Quy tắc 3–5: Cách viết skill Claude vừa đủ, đúng model, đúng thứ cần nói
Quy tắc 3: Mức tự do tương xứng với rủi ro
Mức chi tiết của chỉ dẫn phải tương xứng với rủi ro của công việc. Anthropic ví có những việc như một cây cầu hẹp, hai bên là vực: chỉ có một lối đi an toàn. Có những việc lại như cánh đồng trống, đi lối nào cũng tới. Từ đó có ba mức tự do cho AI:
- Tự do cao: chỉ nói mục tiêu.
- Tự do vừa: cho một khung, bên trong được linh hoạt.
- Tự do thấp: bắt làm đúng từng bước.
Một skill có thể dùng cả ba mức. Trong skill báo giá, phần tính tiền là cây cầu hẹp: sai một con số là mất tiền thật, nên Claude không được cộng nhẩm mà phải chạy đúng một lệnh script tính. Phần viết email là cánh đồng: mình chỉ bắt buộc có tổng tiền, tiền cọc và ngày hết hạn, còn lại Claude tự viết theo văn phong mẫu có sẵn.
Hãy phân định rõ chỗ nào phải chặt, chỗ nào được linh hoạt. Với các model Claude mới, khóa chặt mọi thứ thì chính chất lượng đầu ra bị kìm lại. Nếu bạn thấy kết quả chưa như ý, có thể skill đang vi phạm quy tắc này.
Quy tắc 4: Test trên đúng model bạn dùng
Anthropic viết: “Test your Skill with all the models you plan to use it with.” Mỗi model cần một câu hỏi khác nhau:
- Haiku: skill đã đủ hướng dẫn chưa?
- Sonnet: skill có rõ và gọn không?
- Opus: skill có đang giải thích thừa không?
Anthropic còn nói thẳng: skill viết cho model đời trước thường quá chi tiết với model mới và có thể làm kết quả tệ hơn.
Mình chạy bài test Nhà hàng Lửa, mỗi lượt trong một phiên hoàn toàn mới:
| Model | Skill bản cũ | Skill bản mới |
|---|---|---|
| Haiku | Báo 69.300.000₫, thiếu 20.790.000₫ vì bỏ sót phụ phí làm gấp. Cọc sai, hạn sai, email tự bịa “100+ website nhà hàng”. | Đúng hết, tick đủ 5 bước, dừng chờ duyệt. |
| Opus | Đúng tổng tiền, nhưng phải đọc gần 50.000 ký tự. Chính nó nhận xét skill bị độn nhiều nội dung lặp. | Đúng hết. |
Model mạnh bù được skill viết kém, nhưng bạn trả bằng token. Model nhẹ thì không bù được, và bạn có thể trả bằng tiền thật.
Test mọi skill trên mọi model rất tốn token. Hãy ưu tiên skill bạn dùng nhiều nhất và skill mà sai một lần là mất tiền.
Quy tắc 5: Chỉ viết thứ Claude chưa biết
Anthropic gọi context window là tài sản chung (“The context window is a public good”), và chỉ nên thêm những gì Claude chưa biết. Skill cũ mở đầu bằng “báo giá là gì”, “VAT là gì”, “cách tính phần trăm”. Claude biết hết rồi. Thứ nó không biết là bảng giá của studio, ai là khách cũ, được giảm bao nhiêu.
Phần mô tả (description) của skill cũng vậy: viết ở ngôi thứ ba, nói rõ làm gì và dùng khi nào.
- Đừng viết: “Tôi có thể giúp bạn làm báo giá.”
- Hãy viết: “Lập báo giá dịch vụ… Dùng khi người dùng cần báo giá.”
Quy tắc 6–8: Giúp skill Claude tự kiểm lỗi và ra đúng định dạng
Quy tắc 6: Checklist và dòng quay lại
Việc nhiều bước thì đưa cho Claude một checklist để nó chép ra và tick dần. Nhưng phần quan trọng nhất là dòng quay lại. Ví dụ của chính Anthropic kết thúc bằng câu: nếu kiểm tra không đạt, quay lại Bước 2. Không có dòng này, checklist dễ bị tick cho xong rồi giao luôn.
Bản mới có Bước 3: đối chiếu với yêu cầu của khách, sai chỗ nào thì quay lại Bước 1. Khi test lại, cả Haiku lẫn Opus đều chép checklist ra và tick đủ 5 bước.
Quy tắc 7: Vòng lặp kiểm, sửa, lặp lại
Anthropic viết: “Run validator → fix errors → repeat. This pattern greatly improves output quality.” Bộ kiểm không nhất thiết là code, một file hướng dẫn văn phong cũng được. Nhưng nếu có script, hãy cho nó báo lỗi thật rõ: không chỉ ghi “lỗi”, mà nói lỗi gì, nằm ở đâu.
LỖI: "ANH-SP" tối thiểu 10 ảnh, yêu cầu đang là 6.- Gõ sai mã dịch vụ thì script liệt kê luôn các mã đang có.
Đọc lỗi như vậy, Claude tự sửa được, chạy lại cho tới khi đạt.
Quy tắc 8: Template, ví dụ và ngã rẽ
Khi cần đầu ra đúng hình dạng, bạn có ba cách:
- Template: nói rõ là bắt buộc giống y nguyên, hay chỉ là gợi ý.
- Ví dụ: đưa cặp đầu vào và đầu ra mẫu. Theo Anthropic, ví dụ truyền văn phong rõ hơn mọi lời mô tả.
- Ngã rẽ: báo giá mới thì đi lối này, sửa báo giá cũ thì đi lối kia.
Ví dụ mạnh tới mức nào? Skill cũ có một email mẫu “Kính gửi Quý khách, tôi xin gửi báo giá”, và model viết ra đúng giọng đó. Skill mới có ví dụ thân thiện hơn, email ra cũng thân thiện theo. Ví dụ sai giọng thì kết quả cũng sai giọng.
Quy tắc 9–10: Đóng gói skill Claude để chia sẻ và khóa luật sống còn bằng hook
Quy tắc 9: Viết để người khác dùng được
Sớm muộn bạn sẽ chia skill cho đồng nghiệp, cho team hoặc cho khách. Đừng giả định máy người khác đã cài sẵn công cụ như máy bạn.
- Skill cũ bảo chạy một file Python gửi mail, không nói cần cài gì, và lưu vào ổ
D:\của riêng một máy. - Bản mới có mục “Cần có” nói rõ cần cài gì (chỉ cần Node 18 trở lên), mọi đường dẫn đều tương đối.
- Luôn dùng dấu gạch chéo xuôi
/trong đường dẫn, kể cả trên Windows.
Quy tắc 10: Luật sống còn đưa vào hook
Đây là quy tắc ít người dùng nhất, nhưng quan trọng nhất. Skill cũ viết: “LUÔN LUÔN PHẢI HỎI CHỦ STUDIO TRƯỚC KHI GỬI BÁO GIÁ TRÊN 50 TRIỆU!!!”. Phần lớn thời gian Claude sẽ nghe. Nhưng với tiền thật, “phần lớn thời gian” là không đủ.
Hook là một đoạn code nhỏ mà Claude Code tự chạy mỗi khi một sự kiện xảy ra, dù Claude có đang làm theo skill hay không. Bạn có thể khai báo hook ngay trong phần đầu (frontmatter) của skill.
Trong skill báo giá, trước mỗi lệnh, hook đọc báo giá sắp gửi. Trên 50 triệu thì bắt buộc dừng lại hỏi người. Khi thử gửi báo giá 90 triệu, hook bật hộp xác nhận ngay. Báo giá 21 triệu thì đi qua bình thường.
Hãy chọn vài luật mà sai một lần là mất tiền, mất dữ liệu hoặc mất khách, rồi đưa chúng vào hook.
Mẹo thêm từ tài liệu Claude Code: khi hội thoại dài bị nén lại, Claude chỉ giữ khoảng 5.000 token đầu của mỗi skill. Vì vậy luật quan trọng nhất phải nằm ngay đầu file.
Muốn đi sâu hơn về cách các mảnh workflow, skill và vòng lặp ghép thành một agent, bạn có thể đọc thêm bài Kiến trúc AI Agent: Harness, Loop và Graph là gì?
Câu hỏi thường gặp khi viết skill Claude
Viết skill Claude có cần biết code không?
Không. Skill là file văn bản viết bằng tiếng Việt bình thường, có các bước và checklist. Chỉ phần cần chính xác tuyệt đối như tính tiền hay hook mới cần một script nhỏ.
Có cần test mọi skill trên mọi model không?
Không cần, vì rất tốn token. Hãy ưu tiên skill bạn dùng nhiều nhất và skill mà sai một lần là mất tiền.
Viết luật bằng chữ in hoa trong skill có đủ không?
Phần lớn thời gian Claude sẽ nghe, nhưng không phải mọi lúc. Luật liên quan tới tiền, dữ liệu hay khách hàng nên đưa vào hook, vì hook luôn chạy dù Claude có làm theo skill hay không.
Làm sao biết skill hiện tại của mình vi phạm quy tắc nào?
Dùng Prompt Audit bản tiếng Việt mình chia sẻ trong video: dán vào Claude Code, đổi đường dẫn thư mục skill. Claude báo cáo trước những gì cần sửa, và chỉ sửa những mục bạn duyệt.
Kết luận: 3 điều cần nhớ khi viết skill Claude
Nếu chỉ nhớ ba điều từ 10 quy tắc này:
- Skill ngắn và đặt thông tin đúng chỗ.
- Luôn có dòng quay lại bước trước khi kiểm tra không đạt.
- Luật cần chính xác cao thì đưa vào hook và để ở đầu skill.
Cùng một model rẻ nhất, chỉ đổi cách viết skill, kết quả đi từ báo thiếu 20 triệu thành đúng tới từng đồng. Viết skill đúng cách vừa tiết kiệm token với model mạnh, vừa giúp model rẻ làm đúng việc. Việc nên làm ngay hôm nay: mở skill bạn dùng nhiều nhất và chạy Prompt Audit bản tiếng Việt (kèm bảng 10 quy tắc và câu gốc của Anthropic) — nhận Prompt Audit tại đây.
Nếu bạn muốn hiểu cách biến những skill riêng lẻ thành một hệ thống làm việc hằng ngày, đọc thêm Cách biến Claude từ chatbot thành hệ thống làm việc. Theo dõi fanpage GiangxAI để nhận các bài hướng dẫn mới.
Muốn có sẵn một đội agent đã viết theo đúng các quy tắc này? Bộ AI Agent của GiangXAI Lab gồm 8 AI Agent và 40+ skill thực chiến cho research, content, video, trang bán hàng, thanh toán và báo cáo, giá 2.399.000₫ một lần, dùng trọn đời. Xem chi tiết Bộ AI Agent.