1. Skills là gì?
Một Skill là một thư mục chứa tập hợp hướng dẫn (dưới dạng Markdown + YAML) để dạy Claude cách xử lý một loại công việc cụ thể. Thay vì giải thích lại mỗi lần hỏi, bạn đóng gói kiến thức, quy trình, và best practices vào một folder – Claude sẽ tự động áp dụng khi cần.
Cấu trúc một Skill folder:
your-skill-name/ ├── SKILL.md # Bắt buộc – file hướng dẫn chính (Markdown + YAML frontmatter) ├── scripts/ # Tùy chọn – code thực thi (Python, Bash...) ├── references/ # Tùy chọn – tài liệu tham khảo └── assets/ # Tùy chọn – template, font, icon...
Điểm mấu chốt: Skill không phải là plugin hay extension phức tạp. Nó chỉ là một folder với file SKILL.md – đơn giản nhưng rất mạnh.
2. Tại sao nên dùng Skills? (Lợi ích thực tế)
2.1. Không cần lặp lại prompt
Vấn đề lớn nhất khi làm việc với AI là mỗi cuộc hội thoại mới bắt đầu từ số 0. Bạn phải giải thích lại coding convention, style guide, workflow mỗi lần. Skill giải quyết triệt để: dạy một lần, Claude nhớ mãi.
2.2. Kết quả nhất quán
Khi cả team dùng chung một Skill, mọi người sẽ nhận được output theo cùng một chuẩn – không phụ thuộc vào khả năng viết prompt của từng người.
2.3. Tiết kiệm token và thời gian
Tài liệu Anthropic cho thấy một ví dụ so sánh: không có Skill thì mất 15 tin nhắn qua lại + 12,000 token; có Skill chỉ cần 2 câu hỏi làm rõ + 6,000 token. Giảm 50% token và 85% số tin nhắn.
2.4. Hoạt động đa nền tảng
Một Skill viết một lần chạy được trên cả Claude.ai, Claude Code, và API – không cần sửa đổi gì.
2.5. Kết hợp với MCP (Model Context Protocol)
Nếu bạn đang dùng MCP để kết nối Claude với các dịch vụ (Notion, Linear, GitHub, Sentry…), Skill chính là lớp “kiến thức” trên lớp “kết nối”:
| MCP (Kết nối) | Skill (Kiến thức) |
|---|---|
| Kết nối Claude với dịch vụ (Notion, Linear…) | Dạy Claude cách dùng dịch vụ hiệu quả |
| Cung cấp dữ liệu real-time và tool | Đóng gói workflow và best practices |
| Claude có thể làm gì | Claude nên làm gì |
Anthropic ví von: MCP là căn bếp chuyên nghiệp (dụng cụ, nguyên liệu), Skill là công thức nấu ăn (hướng dẫn từng bước). Có căn bếp mà không có công thức thì vẫn nấu được, nhưng không nhất quán và phải thử nhiều lần.
3. Nguyên tắc thiết kế cốt lõi (3 trụ cột)
3.1. Progressive Disclosure (Tiết lộ dần)
Skill dùng hệ thống 3 tầng để tiết kiệm token:
- Tầng 1 – YAML frontmatter: Luôn được load vào system prompt. Chỉ chứa tên và mô tả ngắn để Claude biết khi nào cần dùng skill này.
- Tầng 2 – SKILL.md body: Chỉ load khi Claude thấy skill phù hợp. Chứa toàn bộ hướng dẫn chi tiết.
- Tầng 3 – File liên kết: Chỉ được đọc khi thực sự cần (scripts, references, assets).
Bài học: Đây là một kiến trúc rất thông minh. Thay vì nhồi hết mọi thứ vào context, Claude chỉ load những gì cần thiết – giống như lazy loading trong web development.
3.2. Composability (Kết hợp được)
Claude có thể load nhiều Skill cùng lúc. Mỗi Skill nên hoạt động độc lập, không giả định mình là Skill duy nhất.
3.3. Portability (Di động)
Một Skill hoạt động giống nhau trên Claude.ai, Claude Code và API. Viết một lần, chạy mọi nơi.
4. Tóm tắt các điểm chính từ tài liệu
4.1. 3 loại Skill phổ biến
| Loại | Mục đích | Ví dụ |
|---|---|---|
| Category 1: Tạo tài liệu & asset | Tạo output nhất quán (code, document, design, slide…) | frontend-design – tạo giao diện web production-grade |
| Category 2: Tự động hóa workflow | Quy trình nhiều bước cần nhất quán | skill-creator – hướng dẫn tạo Skill mới |
| Category 3: Nâng cao MCP | Thêm workflow cho MCP server có sẵn | sentry-code-review – tự động review code từ Sentry data |
4.2. Cách viết YAML frontmatter hiệu quả
Frontmatter là phần quan trọng nhất – quyết định Claude có load skill hay không:
--- name: sprint-planner description: Manages Linear project workflows including sprint planning, task creation, and status tracking. Use when user mentions "sprint", "Linear tasks", "project planning", or asks to "create tickets". ---
Quy tắc vàng:
- name: dùng kebab-case, không viết hoa, không dấu cách
- description: phải gồm skill làm gì + khi nào dùng (trigger phrases)
- Không dùng XML tag (< >) trong frontmatter (lý do bảo mật)
- Không đặt tên có chữ “claude” hoặc “anthropic” (reserved)
4.3. 5 Pattern thiết kế Skill
- Sequential Workflow: Quy trình nhiều bước theo thứ tự (onboard khách hàng, deploy pipeline…)
- Multi-MCP Coordination: Kết hợp nhiều MCP server (Figma → Google Drive → Linear → Slack)
- Iterative Refinement: Lặp lại để cải thiện chất lượng (tạo báo cáo, kiểm tra, sửa, lặp lại)
- Context-aware Tool Selection: Chọn tool tùy ngữ cảnh (file lớn → cloud, code → GitHub, doc → Notion)
- Domain-specific Intelligence: Nhúng kiến thức chuyên môn (compliance, quy trình nội bộ…)
4.4. Testing và Iteration
Tài liệu đề xuất 3 cấp độ test:
- Triggering test: Skill có tự động load khi cần không? Có load nhầm không?
- Functional test: Output có đúng không? API call có thành công không?
- Performance comparison: So sánh với/không có Skill (token, số bước, độ chính xác)
Mẹo hay từ Anthropic: Hãy iterate trên một task duy nhất cho đến khi Claude làm đúng, rồi mới trích xuất cách làm thành công đó thành Skill. Đừng viết Skill rồi mới test – làm ngược lại sẽ nhanh hơn.
4.5. Phân phối và chia sẻ
- Cá nhân: Upload file zip lên Claude.ai (Settings > Capabilities > Skills) hoặc đặt vào thư mục Skills của Claude Code
- Tổ chức: Admin deploy Skill toàn workspace (tính năng từ 12/2025)
- Cộng đồng: Host trên GitHub với README và hướng dẫn cài đặt
- API: Dùng endpoint /v1/skills cho ứng dụng và agent tự động
Đặc biệt, Anthropic đã công bố Agent Skills là một open standard – giống như MCP, Skills được thiết kế để hoạt động đa nền tảng, không chỉ riêng Claude.
5. Những bài học rút ra
5.1. “Dạy” AI thay vì “ra lệnh” AI
Skill thay đổi cách tư duy về AI: thay vì viết prompt mỗi lần (ra lệnh), bạn đóng gói kiến thức để AI tự biết cách làm (dạy). Đây là bước tiến quan trọng từ “AI assistant” sang “AI colleague”.
5.2. Kiến thức chuyên môn là lợi thế cạnh tranh
AI có thể viết code, nhưng không biết quy trình nội bộ của team bạn, coding convention riêng, hay business logic đặc thù. Người nào đóng gói được kiến thức này thành Skill sẽ có lợi thế lớn.
5.3. Đơn giản nhưng không tầm thường
Về mặt kỹ thuật, Skill chỉ là một folder với file Markdown. Nhưng sức mạnh nằm ở kiến trúc Progressive Disclosure – chỉ load những gì cần, khi cần. Đây là một bài học thiết kế đáng học cho bất kỳ hệ thống nào.
5.4. Skill là “tài liệu sống”
Anthropic nhấn mạnh: Skill không phải viết một lần là xong. Bạn cần theo dõi, phát hiện under-triggering / over-triggering, và cập nhật liên tục. Giống như maintain code vậy.
6. Góc nhìn cá nhân: Áp dụng Skills vào dự án thực tế
6.1. Skill cho Laravel/PHP project
- Laravel coding convention: Dạy Claude cách đặt tên controller, service, repository, migration… theo chuẩn team
- API response format: Đảm bảo mọi API Claude tạo đều trả về đúng format
{data, message, status} - Database migration workflow: Quy trình tạo migration → model → factory → seeder → test theo đúng thứ tự
- Code review checklist: Claude tự kiểm tra N+1 query, mass assignment, validation rules… trước khi trả code
6.2. Skill cho team workflow
- Sprint planning skill: Kết hợp với Linear/Jira MCP để Claude tự tạo task từ requirement doc
- PR review skill: Kết hợp với GitHub MCP + Sentry MCP để review code dựa trên error data thực tế
- Documentation skill: Tự động tạo API doc, changelog từ commit history
6.3. Skill cho cá nhân
- Blog writing skill: Dạy Claude viết blog theo phong cách riêng (structure, tone, format HTML)
- Video script skill: Tạo script video YouTube theo template cố định (hook → nội dung → CTA)
- Learning note skill: Claude tổng hợp tài liệu thành dạng ghi chú cá nhân hóa
Nhận định: Skill không chỉ dành cho developer. Bất kỳ ai có workflow lặp lại đều có thể hưởng lợi: marketing, content, HR, finance… Chỉ cần biết viết Markdown là có thể tạo Skill.
7. Bắt đầu nhanh trong 15 phút
Tài liệu Anthropic nói bạn có thể tạo Skill đầu tiên trong 15-30 phút. Đây là các bước:
- Xác định use case: Chọn 1 workflow lặp lại nhiều nhất của bạn
- Tạo folder:
mkdir my-first-skill - Viết SKILL.md: Bắt đầu với YAML frontmatter (name + description) rồi thêm hướng dẫn chi tiết
- Upload & test: Upload lên Claude.ai (Settings > Capabilities > Skills) và thử với các prompt khác nhau
- Iterate: Sửa description nếu skill không trigger đúng, thêm hướng dẫn nếu output chưa đạt
Hoặc dùng skill-creator (có sẵn trong Claude.ai): gõ “Use the skill-creator skill to help me build a skill for [use case]”
8. Kết luận
The Complete Guide to Building Skills for Claude không chỉ là tài liệu kỹ thuật – nó cho thấy hướng đi của Anthropic: biến Claude từ chatbot thành nền tảng có thể tuỳ biến sâu.
Với Skills, bạn không chỉ dùng AI – bạn đào tạo AI theo cách của mình. Đây là lợi thế mà không phải công cụ AI nào cũng cung cấp.
Tài liệu tham khảo
- The Complete Guide to Building Skills for Claude (PDF) – Anthropic
- Skills Documentation – Anthropic Docs