# Định dạng skill mang đi được, việc triển khai thì không

> Khoá hai tiếng của DeepLearning.AI và Anthropic đáng học, miễn là bạn đọc thêm tài liệu của từng nền tảng.

Bản gốc: https://fdetimes.net/vi/sach-khoa-hoc/khoa-agent-skills-with-anthropic-deeplearning-ai/

Trang giới thiệu khoá *Agent Skills with Anthropic* đưa ra một lời hứa: skill theo định dạng chuẩn mở, nên bạn viết một lần rồi triển khai trên mọi agent hỗ trợ skill. Tài liệu Claude API thì ghi một dòng khô hơn: custom skill không đồng bộ giữa các nơi, upload lên chỗ này thì chỗ khác không tự có.

Hai câu không mâu thuẫn nhau. Thứ mang đi được là định dạng. Còn deployment, tức chuyện upload, phạm vi chia sẻ và môi trường chạy, phải làm lại ở từng nơi, và với FDE đó mới là chỗ dự án ở phía khách dễ gãy.

Vì thế khoá vẫn đáng hơn hai tiếng của bạn, miễn là bạn học như một kỹ sư sắp phải chịu trách nhiệm cho hệ thống chạy thật, chứ không phải người xem demo.

## Một khoá ngắn, do người của Anthropic dạy

DeepLearning.AI làm khoá này cùng Anthropic và công bố trên diễn đàn cộng đồng ngày 28/1/2026. Giảng viên là Elie Schoppik, Head of Technical Education tại Anthropic. Khoá xếp mức Beginner, dài 2 giờ 19 phút, và trang khoá ghi lần cập nhật gần nhất là 17/7/2026.

Trang ghi "10 Lessons" nhưng outline liệt kê 12 mục, nên đừng bất ngờ khi tự đếm. Ba bài đáng chú ý nhất dành riêng cho từng nền tảng: Claude API (17 phút), Claude Code (24 phút) và Claude Agent SDK (20 phút). Trang chỉ mô tả các bài này rất ngắn, nên bạn không biết trước chúng đi sâu tới đâu vào chuyện triển khai.

Thông báo của DeepLearning.AI mô tả skill là thư mục hướng dẫn, mở rộng khả năng của agent bằng kiến thức chuyên biệt. Với FDE, kiến thức chuyên biệt đó thường là quy trình nghiệp vụ của khách, thứ bạn thu được qua customer discovery và muốn agent dùng lại mỗi lần.

## Ý thứ nhất: skill chỉ là một thư mục

Bài kỹ thuật của Anthropic ngày 16/10/2025 định nghĩa skill là một thư mục chứa file SKILL.md. Định nghĩa đơn giản ấy có hệ quả thực tế ngay. Trong Claude Code, skill cá nhân nằm ở `~/.claude/skills/`, còn skill theo dự án nằm ở `.claude/skills/`.

Vì nằm ngay trong repo, skill của dự án được commit, được review trong pull request và được bàn giao cùng mã nguồn. Kiến thức về khách nhờ vậy không còn nằm trong đầu một người.

**Điểm mấu chốt:** Skill tốt là kiến thức của khách được đóng gói thành code, có review và có bàn giao.

## Ý thứ hai: định dạng đi được sang cả nhà cung cấp khác

Lời hứa "viết một lần" là lời quảng bá của khoá, nhưng có bằng chứng độc lập. Anthropic cho biết skill chạy trên bốn sản phẩm của họ và đã công bố định dạng này thành chuẩn mở, và trang agentskills.io xác nhận nguồn gốc đó. Thuyết phục hơn cả là OpenAI Codex xây skill trên cùng chuẩn, với SKILL.md bắt buộc có `name` và `description`.

Nếu khách dùng cả Claude lẫn Codex, bạn không phải viết lại phần hướng dẫn. Vì Codex bắt buộc hai trường `name` và `description`, nên viết chúng cẩn thận ngay từ đầu nếu bạn muốn skill sang được Codex mà không phải sửa.

## Ý thứ ba: triển khai phải làm lại ở từng nơi

Thử hình dung một khách có backend gọi Claude API, đội kỹ sư dùng Claude Code và một nhóm khác dùng Codex. Bạn chỉ có một thư mục skill, nhưng phải đi ba đường triển khai.

Trên API, bạn upload và skill dùng chung cả workspace. Với Claude Code, bạn commit vào `.claude/skills/`. Ở Codex, bạn chọn đặt skill ở mức repo, user, admin hay system, hoặc phân phối qua plugin nếu muốn dùng ngoài một repo.

Tài liệu Claude API ghi rõ hai môi trường FDE hay gặp nhất khác nhau ở những điểm sau.

| | Claude API | Claude Code |
|---|---|---|
| Mạng và API bên ngoài | Không có | Có, như mọi chương trình khác trên máy |
| Cài package lúc chạy | Không được | Tài liệu không nêu giới hạn này |
| Phạm vi chia sẻ | Cả workspace | Thư mục cá nhân hoặc theo dự án |
| Đồng bộ với nơi khác | Không tự đồng bộ, phải upload riêng | Không tự đồng bộ |

Thử đặt một skill cụ thể vào bảng trên. Giả sử skill gọi một API nội bộ để lấy danh mục sản phẩm của khách. Trong Claude Code nó chạy được vì có mạng, nhưng upload lên API thì nó hỏng, vì ở đó skill không gọi được ra ngoài. Định dạng vẫn y nguyên, chỉ có môi trường đổi.

Tài liệu Claude cũng khuyên coi skill như phần mềm cài vào hệ thống, và dẫn sang một trang riêng về quản trị, kiểm duyệt và triển khai ở quy mô tổ chức. Riêng việc có trang đó cho thấy deployment là một mảng tách biệt, nằm ngoài lời hứa về định dạng.

## Học theo thứ tự nào, và đưa gì vào CV

Nên đọc bài kỹ thuật "Equipping agents for the real world with Agent Skills" của Anthropic trước, rồi mới xem khoá. Học xong ba bài nền tảng, hãy mở ngay trang tổng quan Agent Skills trong tài liệu Claude API để bù phần trang khoá không nói. Nếu khách dùng Codex, đọc thêm trang Build skills của OpenAI.

Bài tập đáng làm nhất là đưa một skill lên hai nền tảng và ghi lại mọi thứ phải đổi. Trong CV, đừng chỉ ghi tên khoá. Hãy viết một dòng cụ thể, kiểu "đưa cùng một skill lên Claude Code và Claude API, xử lý giới hạn không có mạng".

Chứng chỉ cho thấy bạn đã xem hết khoá. Một README ghi rõ skill không chạy được ở đâu mới cho thấy bạn đã triển khai thật.

**Thử ngay tuần này:**

- Viết một SKILL.md có name và description cho một việc lặp lại trong dự án, rồi commit nó vào .claude/skills/ của repo
- Cho cùng skill đó chạy trên một nền tảng thứ hai (Claude API hoặc Codex) và ghi lại mọi thứ bạn phải đổi
- Thêm vào README của skill một mục ghi rõ skill cần mạng hay package nào, và vì thế không chạy được ở đâu

## Nguồn

- [Agent Skills with Anthropic - DeepLearning.AI](https://www.deeplearning.ai/short-courses/agent-skills-with-anthropic/)

- [New course! Enroll in Agent Skills with Anthropic](https://community.deeplearning.ai/t/new-course-enroll-in-agent-skills-with-anthropic/887920)

- [Equipping agents for the real world with Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)

- [Agent Skills - Claude API Docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)

- [Agent Skills Overview](https://agentskills.io/home)

- [Build skills](https://learn.chatgpt.com/docs/build-skills)