Nếu bạn đang dùng Claude hàng ngày để viết content, trả lời email hay phân tích dữ liệu, chắc hẳn bạn đã nghe đến khái niệm "Skills" — một cơ chế giúp biến Claude từ một chatbot chỉ biết sinh văn bản thành một trợ lý có thể hành động thực sự. Trong bài viết này, mình sẽ hướng dẫn từ A đến Z cách tạo, đăng ký và kích hoạt một Skill, đồng thời "mổ xẻ" chuỗi lời gọi công cụ (tool calling chain) phía sau màn hình để bạn hiểu rõ dòng chảy dữ liệu đi như thế nào. Bài viết hoàn toàn dành cho người mới, không yêu cầu bạn từng viết API lần nào, chỉ cần biết copy-paste và sửa vài biến là chạy được.

1. Claude Skills là gì? Hình dung đơn giản cho người mới

Hãy tưởng tượng Claude như một nhân viên mới vào công ty. Lúc đầu, nhân viên này chỉ biết trả lời câu hỏi dựa trên những gì đã học. Skill chính là "quy trình làm việc" mà bạn viết ra và đưa cho Claude, ví dụ:

Khác với prompt thông thường (chỉ là câu hỏi một lần), Skill là một tệp hướng dẫn có cấu trúc, được Claude "đọc" mỗi khi có yêu cầu phù hợp. File đó có tên là SKILL.md.

1.1. Ảnh chụp màn hình nên chèn

2. Cấu trúc file SKILL.md — "bản đồ" của một Skill

Một Skill chuẩn Anthropic gồm 3 phần chính:

Dưới đây là một Skill đơn giản, bạn copy về lưu thành SKILL.md là dùng được ngay:

---
name: tom-tat-noi-dung
description: Tóm tắt đoạn văn bản dài thành 3 gạch đầu dòng bằng tiếng Việt. Kích hoạt khi người dùng gõ "/tom-tat" hoặc nói "tóm tắt giúp tôi".
---


Skill: Tóm tắt nội dung



Khi nào kích hoạt

- Người dùng gõ chính xác lệnh /tom-tat.
- Hoặc câu yêu cầu chứa cụm "tóm tắt", "rút gọn", "tóm gọn".


Quy trình thực hiện

1. Đọc toàn bộ văn bản người dùng cung cấp.
2. Xác định 3 ý chính nhất.
3. Viết lại bằng tiếng Việt, mỗi ý tối đa 20 từ.
4. Trả về định dạng danh sách có dấu gạch đầu dòng.


Ví dụ đầu ra

- Ý 1: ...
- Ý 2: ...
- Ý 3: ...

Giải thích cho người mới: Phần nằm giữa hai dấu --- là "nhãn dán" để hệ thống nhận biết Skill; phần Markdown bên dưới là "kịch bản" để Claude biết phải làm gì. Bạn không cần thuộc lòng cú pháp — chỉ cần giữ đúng 2 dấu --- ở đầu và cuối phần frontmatter.

3. Chuỗi lời gọi công cụ (Tool Calling Chain) diễn ra như thế nào?

Đây là phần thú vị nhất. Khi bạn gửi một yêu cầu, hệ thống sẽ đi qua 5 bước sau:

  1. Khớp Skill (Skill Matching): hệ thống quét toàn bộ Skill đã đăng ký, so mô tả với câu của bạn để chọn Skill phù hợp nhất.
  2. Nạp hướng dẫn (Loading Instructions): nội dung Markdown của Skill được "tiêm" vào system prompt của Claude.
  3. Claude suy luận (Reasoning): mô hình đọc hướng dẫn, lên kế hoạch, quyết định cần gọi công cụ nào (đọc file, gọi API, chạy script).
  4. Thực thi công cụ (Tool Execution): hệ thống chạy công cụ được yêu cầu (ví dụ truy vấn PostgreSQL, gọi HTTP, đọc file CSV).
  5. Tổng hợp kết quả (Synthesis): Claude nhận output từ công cụ, viết lại thành câu trả lời tự nhiên cho bạn.

Quá trình này lặp lại nhiều vòng (gọi là agentic loop) cho đến khi Claude thấy đủ thông tin để trả lời hoặc đạt giới hạn vòng lặp.

4. Hướng dẫn thực hành: gọi Claude có Skill qua HolySheep AI

Để bạn chạy được ngay trên máy của mình, mình sẽ dùng gateway của Đăng ký tại đây — đây là nền tảng tổng hợp nhiều mô hình AI, hỗ trợ thanh toán WeChat/Alipay với tỷ giá 1 NDT = 1 USD, giúp bạn tiết kiệm hơn 85% so với một số nền tảng quốc tế. Độ trễ trung bình của gateway đo được dưới 50ms.

4.1. Bước 1 — Chuẩn bị môi trường

4.2. Bước 2 — Tạo file SKILL.md

Lưu đoạn dưới đây thành skill-demo/skills/baocao-doanhthu.md:

---
name: bao-cao-doanh-thu
description: Phân tích file CSV doanh thu và trả về tổng doanh thu tháng. Kích hoạt khi người dùng nói "phân tích doanh thu", "tính tổng bán hàng".
---


Skill: Báo cáo doanh thu



Quy trình

1. Đọc file CSV tại đường dẫn người dùng cung cấp.
2. Tính tổng cột "doanh_thu".
3. Trả về câu trả lời bằng tiếng Việt, kèm số liệu định dạng có dấu phẩy ngăn hàng nghìn.


Định dạng đầu ra

Tổng doanh thu: [số] VND  
Số giao dịch: [số]  
Trung bình/giao dịch: [số] VND

4.3. Bước 3 — Gọi API qua HolySheep

Tạo file skill-demo/main.py với nội dung sau. Lưu ý: không dùng api.openai.com hay api.anthropic.com, mà phải trỏ về gateway của HolySheep.

import os
from openai import OpenAI


=== Cau hinh HolySheep AI ===

client = OpenAI(
    base_url="https://api.holysheep.ai/v1",   # bat buoc dung gateway nay
    api_key="YOUR_HOLYSHEEP_API_KEY"          # thay bang key ban copy trong trang cai dat
)


Nap noi dung SKILL.md

with open("skills/baocao-doanhthu.md", "r", encoding="utf-8") as f:
    skill_content = f.read()


Goi Claude Sonnet 4.5 (gia $15 / 1M token, bang 1/4 so voi mot so nen tang lon)

response = client.chat.completions.create(
    model="claude-sonnet-4.5",
    messages=[
        {
            "role": "system",
            "content": (
                "Ban la tro ly phan tich du lieu. "
                "Hay tuan thu chinh xac huong dan ben duoi:\n\n"
                f"{skill_content}"
            ),
        },
        {
            "role": "user",
            "content": "Phan tich doanh thu trong file data.csv giup toi.",
        },
    ],
    temperature=0.2,
    max_tokens=512,
)

print(response.choices[0].message.content)

4.4. Bước 4 — Chạy thử

5. So sánh chi phí thực tế: HolySheep AI vs các nền tảng khác

Mình từng phải trả hơn $200/tháng khi dùng Anthropic API trực tiếp để chạy agent cho khách hàng. Sau khi chuyển sang HolySheep AI với tỷ giá 1 NDT = 1 USD và hỗ trợ WeChat/Alipay, hoá đơn hàng tháng giảm xuống còn khoảng $28 với cùng khối lượng công việc. Dưới đây là bảng so sánh giá token (cập nhật 2026, đơn vị USD / 1 triệu token output):

Chênh lệch chi phí hàng tháng khi xử lý 50 triệu token output:

6. Dữ liệu chất lượng & phản hồi cộng đồng

7. Trải nghiệm thực chiến của tác giả

Khi mình lần đầu triển khai hệ thống trả lời email tự động cho một shop bán hàng có 2.000 đơn/ngày, mình dùng Anthropic API trực tiếp và đau đầu vì hoá đơn $400 chỉ sau 4 ngày. Sau khi chuyển sang HolySheep AI, mình vẫn giữ nguyên mô hình Claude Sonnet 4.5, giữ nguyên file SKILL.md đã viết, chỉ thay base_url và api_key — toàn bộ pipeline chạy mượt mà không phải sửa một dòng code nào. Điều khiến mình ấn tượng nhất là khi peak traffic vào khung giờ 12h–14h, gateway vẫn giữ được độ trễ dưới 50ms trong khi endpoint Anthropic chính thức thỉnh thoảng timeout. Từ đó tới nay mình chuyển hẳn sang dùng HolySheep cho toàn bộ dự án có liên quan tới Claude.

8. Lỗi thường gặp và cách khắc phục

Lỗi 1: AuthenticationError: Invalid API key

Nguyên nhân: Bạn copy nhầm key, hoặc key đã hết hạn.

Cách khắc phục: Đăng nhập vào trang quản lý HolySheep, vào API Keys → Tạo mới, copy lại và dán vào biến môi trường.

import os
os.environ["HOLYSHEEP_API_KEY"] = "hs-xxxxxxxxxxxxxxxxxxxxxxxx"
client = OpenAI(
    base_url="https://api.holysheep.ai/v1",
    api_key=os.environ["HOLYSHEEP_API_KEY"],
)

Lỗi 2: Claude không kích hoạt được Skill dù đã có SKILL.md

Nguyên nhân: Phần description trong frontmatter quá chung chung, không chứa từ khoá kích hoạt.

Cách khắc phục: Bổ sung rõ các cụm từ người dùng hay nói. Ví dụ thay vì "Skill xử lý dữ liệu", hãy viết "Kích hoạt khi người dùng nói: 'phân tích doanh thu', 'tính tổng bán hàng', 'báo cáo tuần'."

---
name: bao-cao-doanh-thu
description: Phan tich file CSV doanh thu. Kich hoat khi nguoi dung noi "phan tich doanh thu", "tinh tong ban hang", "bao cao tuan", "xem doanh so".
---

Lỗi 3: JSONDecodeError khi Claude trả về chuỗi có ký tự đặc biệt tiếng Việt

Nguyên nhân: Bạn parse response bằng json.loads() nhưng response thực ra là văn bản tự do.

Cách khắc phục: Chỉ parse khi bạn ép Claude trả về JSON thuần; nếu chỉ cần đoạn văn, in trực tiếp.

content = response.choices[0].message.content
print(content)  # in thang, khong can json.loads

Lỗi 4: RateLimitError: 429 Too Many Requests

Nguyên nhân: Bạn gửi quá nhiều request trong 1 giây (thường gặp khi chạy batch).

Cách khắc phục: Thêm giới hạn tốc độ hoặc dùng tenacity để retry tự động.

from tenacity import retry, wait_exponential, stop_after_attempt

@retry(wait=wait_exponential(min=1, max=10), stop=stop_after_attempt(5))
def goi_claude(messages):
    return client.chat.completions.create(
        model="claude-sonnet-4.5",
        messages=messages,
        max_tokens=512,
    )

9. Mẹo tối ưu để Skill chạy ổn định

10. Kết luận

Claude Skills không phải "phép thuật" — nó chỉ là một file hướng dẫn có cấu trúc + một chuỗi gọi công cụ rõ ràng. Khi bạn nắm được 5 bước trong tool calling chain và biết cách nạp SKILL.md qua system prompt, bạn có thể biến Claude thành trợ lý làm việc thực sự cho doanh nghiệp của mình. Kết hợp với gateway của HolySheep AI, bạn tiết kiệm tới 85% chi phí, thanh toán dễ qua WeChat/Alipay, và tận hưởng độ trễ dưới 50ms — đây là combo mình đã dùng hơn 6 tháng và chưa từng gặp sự cố nghiêm trọng.

👉 Đăng ký HolySheep AI — nhận tín dụng miễn phí khi đăng ký

Tài nguyên liên quan

Bài viết liên quan