PHẦN XIII — CLAUDE SKILLS

---

8.1 Skill là gì?

Skill = một "gói chuyên môn đóng sẵn" Claude tự kích hoạt khi phù hợp.

Ví dụ:

• Skill "PowerPoint": Anthropic tạo sẵn. Nói "tạo pptx cho chiến dịch 27/2" → Claude tự gọi Skill, làm file pptx chuyên nghiệp.
• Skill "Vagataba Brand": Bạn tự tạo — chứa brand guidelines + từ cấm TPCN + caption mẫu. Bất kỳ ai viết content → Skill tự load → output đúng brand ngay lần đầu.

So sánh: Skill vs Project vs Project Instructions

💡 Quy tắc chọn: - Rule TPCN áp dụng cho mọi chat → Project Instructions - Chiến dịch tháng 5 có data riêng → Project - Quy trình check content TPCN dùng mãi → Skill

Progressive Disclosure — 3 tầng load

📖 Nguồn: Anthropic Engineering Blog — "Equipping Agents for the Real World with Agent Skills"

Claude KHÔNG load hết nội dung mọi Skill. Thay vào đó dùng 3 tầng:

Tầng 1 — LUÔN LOAD (khi bắt đầu chat):
    Chỉ đọc YAML frontmatter (name + description) của MỌI skill đang bật.
    → Claude biết "tôi có những khả năng gì" nhưng chưa đọc chi tiết.

Tầng 2 — TRIGGERED (khi request khớp):
    Nếu description match câu hỏi → Claude load TOÀN BỘ SKILL.md vào context.
    → Claude đọc quy trình, ví dụ, quy tắc.

Tầng 3 — ON-DEMAND (khi cần thêm):
    Claude navigate đến file trong references/ hoặc scripts/ chỉ khi
    SKILL.md hướng dẫn đọc.
    → Tiết kiệm context cho nội dung chi tiết.

Tại sao NV cần biết? Vì nếu description viết không tốt → Claude không biết skill tồn tại → không gọi → skill hỏng vì description sai. (Xem §13.4)

Khi nào KHÔNG nên tạo Skill

---

8.2 Vì sao Skills quan trọng với Vagataba?

Vấn đề hiện tại (chưa dùng Skills)

• Marketing viết caption — mỗi người nhớ rule khác, vẫn lọt từ cấm.
• Sales mới vào — cần 2 tuần học FAQ + script.
• CS viết tin nhắn — mỗi người tone khác.
• Finance xuất báo cáo — mỗi người template khác.

Sau khi dùng Skills

• Skill "Content Compliance": Tự check caption/ads có vi phạm TPCN, đề xuất sửa.
• Skill "Sales Script": Gõ prompt tư vấn khách → skill tự load script + objection handling chuẩn.
• Skill "Monthly Report": Nói "tạo báo cáo tháng" → Claude dùng template + công thức Vagataba chuẩn.

→ Consistency xuyên team + onboarding nhanh + giảm lỗi.

---

8.3 Skills có sẵn từ Anthropic (dùng ngay)

Cách bật:

1. Settings > Capabilities → bật "Code execution and file creation"
2. Customize > Skills → bật từng Skill
3. Xong. Claude tự kích hoạt khi phù hợp.

🆕 Repo GitHub: github.com/anthropics/skills (130K ⭐) — template + spec + skill mẫu.

---

8.4 Tạo Skill riêng — Step-by-step

Cấu trúc 1 Skill

ten-skill/                    ← folder (tên không dấu, dash thay space)
├── SKILL.md                  ← BẮT BUỘC — metadata + hướng dẫn chính
├── scripts/                  ← (tuỳ chọn) code Python/Bash
│   └── validate_content.py
├── references/               ← (tuỳ chọn) tài liệu chi tiết
│   └── tu-cam-tpcn.md
└── assets/                   ← (tuỳ chọn) file mẫu, JSON schema
    └── caption-mau.json

💡 Tối thiểu: chỉ cần folder + SKILL.md. Nâng cao: thêm scripts/, references/ (giữ SKILL.md < 500 dòng).

Template SKILL.md chuẩn

---
name: ten-skill-khong-dau
description: |
  [Hành động] cho [đối tượng]. Dùng khi user [trigger 1], [trigger 2], hoặc [trigger 3].
  [Trigger tiếng Việt] + [Trigger tiếng Anh].
version: 1.0.0
---

# Tên Skill

## Mục đích
1-2 câu giải thích goal.

## Khi nào Skill này được gọi
- User nói "..." hoặc "..." hoặc "..."
- User upload file loại X
- User hỏi về chủ đề Y

## Quy trình (bước-theo-bước)
1. Bước 1...
2. Bước 2...
3. Bước 3...

## Quy tắc CỨNG
- KHÔNG...
- LUÔN...
- NẾU... THÌ...

## Output Format
[Template hoặc ví dụ output chuẩn]

## Error Handling
- Nếu [lỗi phổ biến]: [cách xử lý]
- Nếu data thiếu: [yêu cầu user bổ sung gì]
- Nếu ngoài scope: [chuyển hướng đến đâu]

## Ví dụ

### Input
"..." (câu user gửi)

### Output
[Output mẫu Claude nên đưa ra]

## Tham khảo thêm
- Xem [references/ten-file.md](./references/ten-file.md)

Best practices khi viết SKILL.md

Viết Description đúng — Kỹ năng quan trọng nhất

⚠️ Lý do #1 khiến Skill thất bại: Description quá chung chung → Claude không biết gọi.

Claude có xu hướng under-trigger (không gọi skill dù nên gọi). Do đó description cần "pushy" — liệt kê rõ trigger.

Checklist description:

1. ✅ Có hành động cụ thể (kiểm tra / soạn / tạo)
2. ✅ Có đối tượng (caption TPCN / tin nhắn inbox)
3. ✅ Có trigger condition ("Dùng khi user yêu cầu X, Y, hoặc Z")
4. ✅ Dùng từ khóa user thực sự gõ
5. ✅ ≤ 1024 ký tự nhưng càng cụ thể càng tốt
6. ✅ Dùng ngôi thứ 3 — KHÔNG dùng ngôi 1/2

Trigger bằng tiếng Việt — Lưu ý

Claude trigger skill dựa trên description. NV Vagataba gõ tiếng Việt mà description chỉ có tiếng Anh → skill không được gọi.

Giải pháp: Description bao gồm cả keyword Việt + Anh:

description: |
  Kiểm tra tuân thủ quy định TPCN cho content Vagataba.
  Validates TPCN advertising compliance with Decree 15/2018.
  Dùng khi user viết caption, ad copy, quảng cáo, hoặc nói
  "check content", "kiểm tra TPCN", "compliance".

Đóng gói & upload

1. Tạo folder với tên skill (không dấu, không space).
2. Trong folder, tạo file SKILL.md.
3. (Tuỳ chọn) Thêm references/, templates/, scripts/.
4. Zip folder — chú ý cấu trúc:

• ✅ vagataba-content-compliance.zip/vagataba-content-compliance/SKILL.md
• ❌ vagataba-content-compliance.zip/SKILL.md

1. Claude.ai → Customize > Skills > + Create skill > Upload → chọn zip.
2. Toggle ON.
3. Test.

Test Skill — 3 bước bắt buộc

⚠️ KHÔNG triển khai skill cho team mà chưa qua 3 bước test.

Bước 1 — Trigger Test (skill có được gọi?):

5 câu KHÁC NHAU mà skill PHẢI được gọi:

Test 1: "Check caption này có vi phạm không: Protein BNK chữa đau khớp..."
Test 2: "Viết ad copy cho BNK"
Test 3: "Review bài đăng Facebook tháng này"
Test 4: "Caption cho chiến dịch Ngày của Mẹ — BNK"
Test 5: "Sửa lại nội dung quảng cáo cho đúng luật TPCN"

→ Nếu < 4/5 trigger → sửa description (thêm từ khóa trigger).

Bước 2 — Anti-Trigger Test (skill có gọi nhầm?):

3 câu mà skill KHÔNG nên được gọi:

Test 1: "Tóm tắt email từ đối tác"
Test 2: "Viết thư cảm ơn cho KOL"
Test 3: "Tạo SOP cho phòng kho"

→ Nếu skill gọi nhầm → thu hẹp description.

Bước 3 — Edge Case Test:

"Viết caption cho sp mới Omega3 (không phải BNK)" → xử lý đúng?
"Caption 500 chữ" → giới hạn?
"Viết caption bằng tiếng Anh" → phản hồi?

---

8.5 12 Skill Vagataba — Thư viện đầy đủ

Bảng tổng hợp 12 Skills

Skill theo vị trí

Skill 1 — Content Compliance (chi tiết)

---
name: vagataba-content-compliance
description: |
  Kiểm tra content TPCN Vagataba có vi phạm quy định pháp lý không, đề xuất sửa.
  Dùng khi user viết caption, ad copy, email marketing cho Protein Bách Niên Kiện.
  Validates TPCN compliance with Decree 15/2018.
  Triggers: "check content", "kiểm tra TPCN", "compliance", "từ cấm".
version: 1.2.0
---

Quy tắc CỨNG:

• Từ CẤM: "chữa", "trị", "đặc trị", "khỏi bệnh", "thay thế thuốc", "hiệu quả 100%", "cam kết khỏi", "tác dụng ngay", "duy nhất", "tốt nhất thế giới"
• Từ ĐƯỢC PHÉP: "hỗ trợ", "bổ sung", "cải thiện", "góp phần", "sản phẩm dinh dưỡng chuyên biệt"
• BẮT BUỘC: Disclaimer cuối mọi ads
• "Facebook" viết đúng (❌ FB, fb, phây, face)

Quy trình:

1. Đọc content → liệt kê mọi cụm có từ CẤM
2. Đề xuất sửa từng cụm
3. Kiểm tra disclaimer → nếu không, thêm
4. Kiểm tra "Facebook"
5. Output: Version 1 (đánh dấu sai) + Version 2 (đã fix) + lý giải

Skill 2 — Sales Script BNK (chi tiết)

---
name: vagataba-sales-script
description: |
  Soạn tin nhắn tư vấn khách hỏi về Protein BNK trên inbox Facebook/Zalo.
  Dùng khi user là Sales, cần viết/sửa tin nhắn trả lời khách.
  Triggers: "tư vấn khách", "soạn tin", "objection", "chốt đơn".
---

Quy trình 5 bước (LUÔN theo):

1. Chào + cảm ơn inbox
2. HỎI thêm thông tin TRƯỚC khi tư vấn (tuổi, bệnh nền, tình trạng)
3. Tư vấn cá nhân hoá
4. Đề xuất combo phù hợp
5. Nhẹ nhàng chốt (không ép)

Escalation BẮT BUỘC: Khách kể tiểu đường nặng, thận, ung thư, hoá trị → KHÔNG tự tư vấn → chuyển chuyên gia.

Skill 3 — Dispatch Verify Call (chi tiết)

---
name: vagataba-dispatch-verify
description: |
  Soạn/điều chỉnh script cuộc gọi xác nhận đơn hàng BNK trước khi ship.
  Dùng khi DV cần script gọi xác nhận, xử lý khách từ chối, flag cờ đỏ.
  Triggers: "script verify", "xác nhận đơn", "cờ đỏ", "DV call".
---

Flow 6 bước (mỗi cuộc ≤ 2 phút):

1. Chào + xác nhận đúng người (15s)
2. Đọc lại đơn hàng — chờ xác nhận TỪNG mục (40s)
3. Hướng dẫn kiểm niêm phong + thanh toán (20s)
4. Hướng dẫn dùng lần đầu (25s)
5. Xác nhận ngày/khung giờ nhận (15s)
6. Cảm ơn + hứa CS theo dõi (10s)

8 cờ đỏ: Đơn 22h-6h, "tôi không đặt", hẹn lại 3 lần, hỏi "trả phí gì không", "mẹ bị lẫn", địa chỉ chung chung, đơn >2tr khách mới, SĐT đã hoàn 2+ đơn.

Skill 4 — CS Follow-up (chi tiết)

---
name: vagataba-cs-followup
description: |
  Soạn tin nhắn chăm sóc khách sau nhận hàng BNK theo timeline D+0 đến D+45.
  Dùng khi CS cần soạn tin chăm sóc, tái đặt, xử lý feedback.
  Triggers: "chăm sóc", "follow-up", "D+", "retention", "tái đặt".
---

Timeline 6 mốc:

• D+0: Welcome + hướng dẫn pha (TYLE SALE: 0%)
• D+2: Check-in nhanh (0%)
• D+7: Kiểm tra phản hồi (0%)
• D+20: Động viên + tip (0%)
• D+28: Gợi ý tái đặt + voucher 100k (~70%)
• D+35: Nhắc cuối + voucher 150k (~60%)

Quy tắc: D+0→D+20 KHÔNG sale. KHÔNG hứa hiệu quả. Mỗi tin ≤ 120 chữ.

Skill 5 — Warehouse FEFO Check (chi tiết)

---
name: vagataba-warehouse-ops
description: |
  Check FEFO compliance, phân tích tồn kho, tạo checklist pick-pack-QC.
  Dùng khi user upload file tồn kho, hỏi check FEFO, hoặc yêu cầu phân tích HSD.
  Triggers: "check FEFO", "tồn kho", "hết hạn", "pick-pack", "QC".
---

Phân loại HSD:

• 🟢 An toàn: HSD > 12 tháng
• 🟡 Cảnh báo: 6-12 tháng
• 🟠 Gấp: 3-6 tháng — plan xả
• 🔴 Khẩn cấp: < 3 tháng — NGỪNG bán cho khách mới

Quy tắc CỨNG:

• KHÔNG BAO GIỜ ship SP HSD < 3 tháng cho khách mới
• KHÔNG ghi lùi HSD trên hệ thống
• Lô huỷ: biên bản + ảnh + 2 chữ ký

Skill 6 — Finance Monthly Report (chi tiết)

---
name: vagataba-finance-report
description: |
  Tạo báo cáo tài chính tháng theo template Vagataba cho CEO.
  Dùng khi user yêu cầu tạo báo cáo thu chi, P&L, cashflow tháng.
  Triggers: "báo cáo tháng", "P&L", "đối soát COD", "tài chính".
---

Template 5 phần: Revenue → COGS → Gross Profit → OpEx → Net Profit. Output: Bảng traffic light (🟢🟡🔴) + variance analysis + 3 insights.

---

8.6 Chia sẻ Skills trong team

Nếu Vagataba dùng Team plan ($25/seat):

1. Owner vào Organization settings > Skills → bật "Share with organization"
2. Người tạo skill → Click Share → chọn:

• Specific people: chia sẻ cho 1-2 NV cụ thể
• Entire organization: publish cho cả Vagataba

1. NV khác thấy trong Shared skills → toggle ON → dùng.

---

8.7 An toàn khi dùng Skills

3 rủi ro chính:

1. Prompt injection: Skill "độc hại" đưa hướng dẫn lén làm Claude rò rỉ data.
2. Data exfiltration: Script gửi data ra ngoài.
3. Malware delivery: Skill tải và chạy mã độc.

⚠️ Case study: MedusaLocker Ransomware (12/2025): Nhóm Cato CTRL chứng minh: skill GIF Creator hợp lệ bị chèn 1 hàm helper → tải script → cài ransomware. Chỉ cần 1 lần approve.

Checklist bảo mật TRƯỚC khi cài skill

• Đọc toàn bộ SKILL.md + references/ + scripts/
• Không có XML tags trong name/description
• scripts/: có try/catch? Gọi URL lạ?
• Tìm từ khóa: http://, curl, wget, requests.get, fetch, base64
• Không có API key, password, token hardcode
• Không có path: ../, ~/.ssh/, /etc/
• Không có "ignore safety", "hide actions"

Nguyên tắc VÀNG:

• CHỈ cài Skill từ: Anthropic chính chủ hoặc tạo nội bộ Vagataba.
• KHÔNG cài Skill từ người lạ mà chưa qua checklist.
• Công cụ scan: SkillCheck by Repello (skills.repello.ai)

---

8.8 Giới hạn kỹ thuật (05/2026)

Skills hoạt động ở đâu:

• ✅ Claude.ai (web/app)
• ✅ Claude Code (CLI) — beta
• ✅ Claude for Excel / PowerPoint add-in
• ✅ API
• ✅ Cowork

---

8.9 Troubleshooting — 13 lỗi thường gặp

---

8.10 Quản lý phiên bản (Version Control)

vagataba-claude-skills/            ← Git repo
├── vagataba-content-compliance/
│   └── SKILL.md
├── vagataba-sales-script/
│   └── SKILL.md
├── vagataba-dispatch-verify/
│   └── SKILL.md
├── vagataba-cs-followup/
│   └── SKILL.md
├── vagataba-warehouse-ops/
│   └── SKILL.md
├── vagataba-finance-report/
│   └── SKILL.md
└── README.md

Quy trình update:

1. Sửa SKILL.md trên local
2. Commit + note (VD: "Thêm từ cấm mới theo NĐ XX")
3. Team lead review + approve
4. Zip + re-upload lên Claude.ai
5. Test lại (trigger test 5 câu)

---

8.11 Lộ trình học Skills cho Vagataba

Tuần 1 — Làm quen (Mọi NV)

Tuần 2 — Tạo Skill mới (Team Lead + Admin)

Tuần 3 — Nâng cao (Admin/CTO)

Theo role

---

Tài liệu tham khảo

1. Anthropic Skills GitHub — github.com/anthropics/skills (130K stars)
2. What are Skills? — support.claude.com/en/articles/12512176
3. Creating Custom Skills — support.claude.com/en/articles/12512198
4. Agent Skills Engineering Blog — anthropic.com/engineering
5. Agent Skills Spec — agentskills.io
6. Skills API Quickstart — docs.claude.com/en/api/skills-guide
7. Anthropic Academy — anthropic.skilljar.com
8. Best Practices Guide — platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
9. Complete Guide PDF — resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf

Khóa học miễn phí

---

Tham chiếu chéo: 12_Claude_Projects.md (§12) | 03_Nghe_Thuat_Viet_Prompt.md (§3) | Skills/ directory Code Skill: Training/Skills/ — 12 folder SKILL.md sẵn dùng.

---