Lời mở đầu
Bạn đã bao giờ gặp tình huống này chưa: Bạn muốn nhờ AI giúp xử lý một tác vụ cụ thể trong dự án, nhưng sau khi nhồi nhét tất cả kiến thức nền tảng, quy chuẩn code, tài liệu API vào Prompt, bạn phát hiện ra Context Window của AI bị nổ tung, hoặc AI bắt đầu nói năng lảm nhảm do quá tải thông tin?
Điều này giống như việc bạn thuê một đầu bếp Michelin, nhưng mỗi lần đều phải đứng bên cạnh lải nhải: “Này, bây giờ thái hành tây, rồi chiên trứng, nhớ thêm muối nhé…” Dù đầu bếp có giỏi đến đâu, nhưng việc bạn cứ phải nói lại mỗi lần như vậy không chỉ khiến bạn kiệt sức mà đầu bếp cũng có thể nghe sót.
Để giải quyết vấn đề này, Claude (Anthropic) đã tung ra một khái niệm mạnh mẽ — Claude Skill (Agent Skill). Bài viết này sẽ đưa bạn đi sâu tìm hiểu xem “công nghệ đen” này là gì, và làm thế nào để tích hợp nó vào dự án của bạn, biến mỗi AI Agent trở thành trợ thủ đắc lực dày dạn kinh nghiệm.
Claude Skill là gì? (Ví dụ đời thường: Công thức bí mật trong nhà bếp)
Nếu muốn giải thích Claude Skill theo cách đơn giản nhất, chúng ta có thể tưởng tượng nó như là “Những thẻ công thức (Recipe Cards) đặt trên kệ bếp của một nhà hàng cao cấp”.
- Prompting thông thường: Giống như bạn đứng bên cạnh đầu bếp (AI) và chỉ đạo bằng miệng.
- Claude Skills (Agent Skills): Chính là việc bạn viết quy trình vận hành tiêu chuẩn (SOP) thành các thẻ công thức.
Những thẻ này thường được cất trong kẹp hồ sơ (hệ thống tệp), và đầu bếp không cần phải học thuộc lòng cả cuốn bách khoa toàn thư (tiết kiệm Context Window). Chỉ khi bạn hô lên “Làm món Bò Wellington đi”, đầu bếp mới đi đến kệ, rút thẻ công thức cụ thể đó ra và làm theo từng bước.
Cấu trúc cốt lõi của Skill
Cấu trúc của Skill thực ra rất đơn giản. Nó chỉ là một thư mục, thường bao gồm ba phần:
SKILL.md: Đây chính là bản thể của công thức. Trong đó viết: “Nếu bạn muốn xử lý PDF, bước một làm thế này, bước hai làm thế kia…”.scripts/(Tùy chọn): Giống như dao gọt vỏ chuyên dụng trong bếp. Đây là các tập lệnh Python hoặc Bash cụ thể để AI thực thi trực tiếp, không cần phải tự bịa ra code.- Metadata (YAML): Nhãn dán trên gáy sách công thức (tên, mô tả), giúp AI quét nhanh là biết công thức này dùng để làm gì.
Tại sao điều này giúp Agent thông minh hơn? (Lợi thế kiến trúc)
Điều này vận dụng một khái niệm tâm lý học/kỹ thuật gọi là “Tiết lộ dần dần (Progressive Disclosure)”.
- Trước khi dùng Skill: Bạn nhồi nhét tất cả quy tắc dự án, quy chuẩn code, tài liệu API cho AI. Dung lượng não (Context Window) của AI nổ tung ngay lập tức.
- Sau khi dùng Skill: AI bắt đầu với trạng thái chỉ biết “Tôi có danh sách các công cụ này (Metadata)”. Khi gặp tác vụ cụ thể, nó mới “đọc” nội dung
SKILL.mdcụ thể đó vào não.
Điều này làm cho AI Agent của bạn giống như một “Kỹ sư cao cấp biết cách tra cứu tài liệu”, chứ không phải một “Mọt sách cố gắng học thuộc lòng cả thư viện”.
Phân tích sâu: Logic vận hành và Định dạng của Skill
Logic vận hành của Claude Skill chia thông tin thành ba cấp độ, cho phép AI “chỉ lấy những gì cần thiết, vào lúc cần thiết”:
| Cấp độ | Nội dung (Content) | Khi nào tải (When Loaded) | Tiêu tốn Token | Ví dụ đời thường |
|---|---|---|---|---|
| Level 1 | Metadata (Siêu dữ liệu) Thẻ YAML: Tên, Mô tả |
Luôn luôn (Always) Đưa vào System Prompt khi khởi động |
Rất ít (~100 tokens) | Thực đơn nhà hàng Bạn nhìn thực đơn là biết có món này, nhưng chưa cần vào bếp. |
| Level 2 | Instructions (Chỉ dẫn) Nội dung dạy trong SKILL.md |
Khi được kích hoạt (Triggered) AI cảm thấy cần thì mới dùng Bash để đọc file |
Trung bình (<5k tokens) | Thẻ công thức Quyết định nấu món này rồi mới rút thẻ này ra xem các bước. |
| Level 3 | Resources & Code Script ( .py) hoặc tài liệu tham khảo |
Khi thực thi (As needed) Chạy script hoặc tra cứu tài liệu cụ thể |
Gần như không tốn Chỉ trả về kết quả thực thi |
Dụng cụ bếp chuyên dụng Lấy máy trộn ra đánh trứng, bạn chỉ cần kết quả, không cần nuốt cả cái máy. |
Ví dụ định dạng SKILL.md
Một file Skill tiêu chuẩn bao gồm phần đầu YAML và nội dung Markdown:
---
name: data-analyzer # Quy tắc: chữ thường, số, gạch nối
description: Analyze data from CSV files and generate charts. Use when the user asks for insights from spreadsheets. # Quy tắc: Mô tả rõ "làm gì" và "dùng khi nào"
---
# Data Analyzer Skill
## Instructions
1. Đầu tiên, kiểm tra đường dẫn file CSV mà người dùng cung cấp.
2. Sử dụng script `scripts/analyze.py` để đọc dữ liệu.
3. Nếu phân tích thành công, hãy tóm tắt xu hướng dữ liệu bằng tiếng Trung phồn thể.
## Examples
User: "Phân tích báo cáo doanh số này giúp tôi"
Assistant: (executes python scripts/analyze.py sales.csv)
Làm thế nào để xây dựng kiến trúc đa năng “xuyên biên giới model”?
Nỗi đau của nhiều người là: “Tôi không muốn bị trói buộc vào Claude! Còn các AI khác (như Gemini, Cursor, VS Code Copilot) thì sao?”
Claude Code sở dĩ có thể tự động quét là vì runtime của nó đã được viết cứng (hardcode) một đoạn logic để duyệt qua .claude/skills. Các Agent khác thì giống như độc giả bước vào thư viện mà không có hệ thống mục lục.
Để giải quyết vấn đề này, chúng ta có thể tạo ra một “Mục lục tổng (Master Index)”.
Giải pháp 1: Tạo SKILLS_INDEX.md
Tạo một file SKILLS_INDEX.md hoặc AGENTS_README.md tại thư mục gốc của dự án, với cấu trúc như sau:
# AI Agent Skills Index
(Lưu ý: Dự án này chứa các Agent Skills được mô đun hóa. Khi bạn gặp các tác vụ sau, vui lòng đọc file SKILL.md tương ứng để nắm quy chuẩn vận hành.)
## Available Skills
| Tên Skill (Skill Name) | Đường dẫn thư mục (Path) | Mô tả chức năng & Thời điểm kích hoạt (Description & When to use) |
| :--- | :--- | :--- |
| PDF Processing | `skills/pdf-processing/SKILL.md` | Sử dụng khi người dùng yêu cầu "Đọc PDF", "Trích xuất bảng", hoặc "Gộp file". |
| Code Review | `skills/code-review/SKILL.md` | Sử dụng khi người dùng yêu cầu "Review Code", "Kiểm tra PR", hoặc "Tối ưu hóa code". |
## How to use
1. Đọc danh sách trên trước.
2. Dựa vào Prompt của người dùng, phán đoán xem Skill nào liên quan nhất.
3. Chủ động đọc (Read) nội dung `SKILL.md` tại đường dẫn đó vào Context.
Việc này giống như “Thực đơn” ở cửa ra vào nhà hàng. Gemini hay Cursor chỉ cần vào dự án và đọc file này là biết ngay “À! Hóa ra mình có những chiêu này để dùng”.
Giải pháp 2: Giải pháp chuyên biệt cho Cursor (.cursorrules)
Nếu bạn đang dùng Cursor, nó có một tính năng mạnh mẽ gọi là .cursorrules. Bạn có thể viết trực tiếp logic mục lục nói trên vào đó để Cursor tự động mount Skill.
You are an advanced AI coding assistant. This project utilizes a standardized "Agent Skills" architecture located in the `skills/` directory.
Before executing complex tasks, verify if a relevant skill exists:
[Skill List]
- name: pdf-processing
- path: skills/pdf-processing/SKILL.md
- description: Extract text and tables from PDF files.
Instruction:
If the user's request matches a skill's description, you MUST read the content of the corresponding `SKILL.md` file before proceeding.
Giải pháp 3: Script tạo tự động
Để tránh phiền phức khi phải bảo trì mục lục thủ công, bạn có thể viết một script update_skills_index.py đơn giản để tự động quét phần đầu YAML của tất cả các file SKILL.md và tạo ra SKILLS_INDEX.md.
Làm thế nào để tạo Skill nhanh chóng?
Không muốn viết YAML và Markdown bằng tay? Bạn có thể dùng “AI Skill” để tạo “AI Skill”!
Anthropic chính chủ có cung cấp một Skill tên là skill-creator, thực chất nó là một “Trình hướng dẫn dạng phỏng vấn (Wizard)”.
- Cài đặt: Bỏ thư mục
skill-creatorvào thư mục skills của bạn. - Triệu hồi: Nói với AI “Này, tôi muốn tạo một Skill mới, hãy dùng skill-creator giúp tôi.”
- Tương tác: Nó sẽ bắt đầu hỏi bạn: “Bạn muốn làm công cụ gì?”, “Có cần viết script Python không?”.
- Tạo: Sau khi đối thoại kết thúc, nó sẽ tự động nhả ra
SKILL.mdvà cấu trúc thư mục chuẩn cho bạn.
Việc này giống như bạn không cần tự vẽ bản thiết kế, mà gọi một con “Robot tạo bản thiết kế” vẽ giúp bạn.
Kết luận
Claude Skills (Agent Skills) không chỉ là tính năng độc quyền của Claude, nó còn là một tiêu chuẩn cộng tác Agent mở. Thông qua cấu trúc file được chuẩn hóa và cơ chế mục lục rõ ràng, chúng ta có thể để kiến trúc mạnh mẽ này vượt qua rào cản model và ứng dụng trong bất kỳ môi trường phát triển AI nào.
Với cuốn “Cẩm nang vận hành nhân viên kỹ thuật số” này, Agent của bạn sẽ không còn là lính mới chỉ biết nói lảm nhảm, mà là chuyên gia cấp cao có thể tra cứu SOP và thực thi nhiệm vụ chính xác bất cứ lúc nào. Hãy bắt đầu xây dựng Skill Standard Library của bạn ngay bây giờ!
Reference
Tutorials
Skills
- skills/skills/skill-creator/SKILL.md at main · anthropics/skills · GitHub
- Agent Skills Marketplace - Claude, Codex & ChatGPT Skills | SkillsMP
- Claude Skills Hub - Discover and Download Skills
- GitHub - ComposioHQ/awesome-claude-skills: A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows