Tại sao nhiều team build AI agent nhưng không scale được khi đưa vào production?

Vì họ vẫn đang nghĩ theo “prompt”… thay vì “hạ tầng kỹ năng”.

Trong bài này, mình không nói lại định nghĩa SKILL.md.

Mình chia sẻ 3 thứ thực sự tạo ra khác biệt rút ra sau khi build 61 skills cho hệ thống Agentic BI thực tế.

---

1️⃣ Progressive Disclosure - Tiết kiệm token theo đúng nghĩa đen

Nhiều người nghĩ: “Agent có càng nhiều skill → càng tốn token.” Sai.

SKILL.md không load toàn bộ nội dung ngay từ đầu.

Nó hoạt động theo 3 tầng:

→ Level 1: Agent chỉ đọc name + description (~30–50 tokens/skill)

→ Level 2: Chỉ khi trigger khớp mới load full body (<5,000 tokens)

→ Level 3: Scripts, references - chỉ gọi khi thực sự cần

Nghe có vẻ đơn giản.

Nhưng khi vào production, đây là khác biệt cực lớn.

✨ Con số thực từ Agentic BI Kit:

• 61 skills × ~50 tokens = ~3,000 tokens để agent “biết” toàn bộ system

• Mỗi lượt chỉ load 2-3 skills liên quan = ~7,000 tokens

• Nếu nhồi toàn bộ 61 prompt vào context? ~300,000 tokens/lượt

→ Tiết kiệm ~97% chi phí token

Không phải lý thuyết.

Đây là production number.

2️⃣allowed_tools - Tối ưu mà 99% mọi người bỏ qua

Trong frontmatter của SKILL.md có một field ít người dùng: allowed_tools

Field này giới hạn skill chỉ được gọi những tool cụ thể. Tại sao quan trọng?

Vì mặc định: Agent sẽ “nhìn thấy” toàn bộ MCP servers đang kết nối.

Mỗi lần agent cần chọn tool → nó phải đọc schema của từng tool.

→ Và điều đó tốn token.

Khi bạn cấu hình: allowed_tools: [pbi_remote, fabric] cho skill “Report Builder”:

→ Agent chỉ thấy 2 tools thay vì 6 MCP servers

→ Giảm token overhead cho tool selection

→ Giảm rủi ro gọi nhầm tool không liên quan

→ Response nhanh hơn, chính xác hơn

Đây là tối ưu mà bạn không thấy trong bất kỳ tutorial nào, nhưng nó tạo ra khác biệt thực sự khi hệ thống có nhiều MCP servers như Agentic AI Analytics.

---

3️⃣ Portable across 16+ tools - viết 1 lần, dùng mọi nơi

SKILL.md là open standard (agentskills.io).

Bạn có thể dùng cùng 1 file trên nhiều hệ sinh thái:

• Claude Code → .claude/skills/

• Cursor → .cursor/skills/

• GitHub Copilot → .github/skills/

• OpenAI Codex → .codex/skills/

• + Gemini CLI, VS Code, JetBrains, Mistral…

Cùng 1 file SKILL.md, copy sang thư mục khác là chạy. Không cần viết lại.

---

Tại sao điều này quan trọng với doanh nghiệp?

Vì team của bạn có thể dùng nhiều AI tools khác nhau, người dùng Claude Code, người dùng Cursor, người dùng Copilot nhưng tất cả chia sẻ chung bộ skills. Kiến thức chuyên môn không bị phân mảnh theo tool.

SKILL.md không chỉ là "viết prompt đẹp hơn."

Đây là chuyển đổi tư duy quan trọng:

‣ Prompt tạm thời → ✅ Hạ tầng kỹ năng vĩnh viễn

‣ Tốn token cho mọi thứ → ✅ Chỉ tốn token khi trigger

‣ Lock-in 1 tool → ✅ Portable across 16+ tools

‣ Kiến thức nằm trong đầu 1 người → ✅ Version-controlled, team-shared

Đây là nền tảng để build Agentic AI system đúng cách - không phải demo, mà là production.

---

Trong chương trình Agentic AI Analytics (Business Intelligence), Mastering Data Analytics sẽ hướng dẫn chi tiết cách thiết kế và triển khai SKILL.md trong hệ thống Agentic BI thực tế - từ cách viết description đúng trigger, cấu trúc thư mục chuẩn, đến tối ưu allowed_tools trong kiến trúc multi-agent.

Tìm hiểu về chương trình bạn sẽ học được kiến thức thật sự nền tảng & ứng dụng thực tế cao, không chỉ kiến thức bề mặt!

🔔+230.000 người đăng ký theo dõi chúng tôi trên các nền tảng: https://www.mastering-da.com/newsletter

📌Các chương trình ANALYTICS ứng dụng vào AGENTIC AI - phiên bản NÂNG CẤP mới nhất 2026, kế thừa nền tảng đào tạo Analytics hàng đầu Việt Nam từ 2020, tập trung vào tư duy phân tích, năng lực ra quyết định và ứng dụng AI trong thực tế doanh nghiệp

→ Agentic AI Analytics (BI) dành cho mọi phòng ban làm việc với dữ liệu: https://mastering-da.com/business-intelligence-program/

→ Agentic AI Finance Analytics (FA) dành cho tài chính, kế hoạch, quản trị: https://www.mastering-da.com/finance-analytics-program

#PhuongThaoAnalytics #AI #Analytics #DataDriven #AgenticAI #MasteringDataAnalytics

Until next time, keep turning data into decisions!