cách cài skill cho claude code là đưa thư mục skill vào ~/.claude/skills, và thư mục đó phải có file SKILL.md chứa hướng dẫn. Sau khi cài, Claude Code tự dùng skill khi thấy phù hợp, hoặc bạn gọi trực tiếp bằng /tên-skill.
Cập nhật: 31/10/2026
Tóm tắt nhanh
- Skill là một thư mục có file SKILL.md chứa hướng dẫn, giúp Claude Code làm theo một quy trình đã định sẵn.
- Với Claude Code, skill được cài vào thư mục ~/.claude/skills trên máy của bạn.
- Cài một skill từ kho chỉ cần một lệnh: tạo thư mục, tải file nén và giải nén vào đó.
- Sau khi cài, bạn gọi skill bằng /tên-skill, hoặc để Claude tự dùng khi thấy liên quan.
- Bạn nên kiểm tra file SKILL.md đã nằm đúng chỗ trước khi dùng skill cho công việc thật.
- Codex CLI, Hermes Agent và DeepSeek dùng thư mục skills riêng và cách gọi skill khác nhau.
Yêu cầu hệ thống để cài skill cho Claude Code là gì?
Bạn cần cài Claude Code trước, vì skill chạy bên trong Claude Code. Máy phải chạy một trong các hệ điều hành được hỗ trợ, có kết nối internet và có một trong các shell dưới đây. Bảng sau tóm tắt yêu cầu theo tài liệu chính thức tại thời điểm cập nhật 31/10/2026.
| Hạng mục | Yêu cầu |
|---|---|
| Hệ điều hành | macOS 13.0 trở lên, Windows 10 (1809) trở lên, Ubuntu 20.04 trở lên, Debian 10 trở lên, Alpine Linux 3.19 trở lên |
| Phần cứng | Tối thiểu 4 GB RAM, bộ xử lý x64 hoặc ARM64 |
| Shell | Bash, Zsh, PowerShell hoặc CMD |
| Kết nối | Cần internet, và khu vực bạn đang ở phải nằm trong danh sách quốc gia được Anthropic hỗ trợ |
Nếu bạn dùng Windows và chưa cài Claude Code, xem hướng dẫn cài Claude Code trên Windows trước khi làm tiếp. Nếu bạn chưa rõ skill là gì, đọc skill Claude là gì để hiểu vì sao skill chỉ nạp nội dung khi cần.
Cách cài skill cho claude code từng bước như thế nào?
Bạn cài Claude Code, tạo thư mục skills, rồi chạy lệnh tải và giải nén skill từ kho. Với skill mẫu claude-d3js-skill, phần việc chính chỉ là hai lệnh trong terminal.
Các bước dưới đây dùng cho macOS, Linux và WSL. Mỗi skill trong kho có một mã id riêng, nên lệnh cài luôn có cùng cấu trúc và chỉ khác phần id.
-
Cài Claude Code nếu máy chưa có. Trên macOS, Linux hoặc WSL, chạy lệnh sau:
curl -fsSL https://claude.ai/install.sh | bashMở cửa sổ terminal mới rồi chạy
claude --version. Nếu lệnh in ra một số phiên bản, Claude Code đã cài thành công. -
Tạo thư mục skills và cài skill claude-d3js-skill:
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/claude-d3js-skill-709f2.tgz | tar xz -C ~/.claude/skillsLệnh
mkdir -ptạo thư mục nếu chưa có. Lệnhtar xz -Cgiải nén skill đúng vào thư mục đó. -
Kiểm tra file SKILL.md đã nằm trong thư mục skills:
find ~/.claude/skills -name SKILL.mdNếu lệnh trả về một đường dẫn, skill đã được cài đúng chỗ.
-
Mở Claude Code, hoặc khởi động lại phiên đang chạy. Gõ
/trong ô nhập để xem danh sách và tìm tên skill.
Trên Windows, chạy lệnh tải và giải nén trong Git Bash hoặc WSL, vì cú pháp trên dùng ~ và && theo kiểu bash. Git for Windows được tài liệu chính thức khuyến nghị để Claude Code dùng Bash tool.
Làm sao kiểm tra skill đã cài đúng chưa?
Bạn kiểm tra bằng hai bước: tìm file SKILL.md trong thư mục skills và xem skill có xuất hiện trong Claude Code hay không. Nếu cả hai đều đạt, skill sẵn sàng để dùng.
Trong Claude Code, chạy /doctor để kiểm tra thiết lập. Lệnh này báo các vấn đề về cài đặt và các skill chưa được dùng, rồi hỏi xác nhận trước khi thay đổi bất kỳ thứ gì. Với kiểm tra không cần mở phiên, bạn có thể chạy claude doctor trong terminal.
| Kết quả | Ý nghĩa | Việc cần làm |
|---|---|---|
| find trả về đường dẫn có SKILL.md | File đã nằm đúng thư mục | Mở Claude Code và gõ / để kiểm tra tên skill |
| find không trả về gì | Lệnh tải hoặc giải nén chưa thành công | Chạy lại lệnh cài, kiểm tra kết nối mạng |
| Có SKILL.md nhưng không thấy trong / | Phiên hiện tại chưa nạp skill mới | Thoát và mở lại Claude Code |
Ví dụ cài và gọi một skill từ kho như thế nào?
Sau khi cài claude-d3js-skill, bạn gọi skill bằng /claude-d3js-skill kèm yêu cầu cụ thể. Skill này hướng dẫn tạo các trực quan hóa dữ liệu tinh vi, tương tác bằng d3.js, nên phù hợp khi bạn cần biểu đồ chạy trên web từ dữ liệu có sẵn.
Ví dụ, bạn có thể gõ: /claude-d3js-skill vẽ biểu đồ cột tương tác từ file doanh-thu.csv. Nếu lệnh không được nhận, gõ / để xem tên đúng trong danh sách, vì tên hiển thị có thể khác với mã id dùng trong lệnh cài. Bạn có thể xem thêm các skill cùng nhóm trong danh mục Dữ liệu khoa học trên kho skill.
Nếu bạn làm nội dung tìm kiếm, skill claude seo có thể phù hợp hơn. Tham khảo thêm skill Claude SEO trên blog để biết cách dùng nhóm skill này.
Thử ngay: Kho skill có hơn 4.000 skill, miễn phí, và mỗi skill chỉ cần một lệnh cài một dòng như trên. Bắt đầu với skill claude-code-guide, bộ tài liệu tổng hợp cách cấu hình và dùng Claude Code hiệu quả.
Codex CLI, Hermes Agent và DeepSeek cài khác Claude Code thế nào?
Cấu trúc lệnh cài giống nhau, chỉ khác thư mục đích và cách gọi skill. Claude Code và Hermes Agent gọi skill bằng /tên-skill, còn Codex CLI gọi bằng $tên-skill. Bảng dưới liệt kê thư mục tương ứng của từng công cụ.
| Công cụ | Thư mục skills | Cách gọi skill |
|---|---|---|
| Claude Code | ~/.claude/skills | /tên-skill |
| Codex CLI | ~/.codex/skills | $tên-skill |
| Hermes Agent | ~/.hermes/skills | /tên-skill |
| DeepSeek (Deep Code CLI) | ~/.deepcode/skills | Xem trang hướng dẫn của công cụ |
Nếu bạn dùng Codex CLI, đọc cách dùng Codex CLI để nắm lệnh cơ bản, sau đó xem trang hướng dẫn Codex trên kho skill. Với Hermes Agent, bạn có thể đọc cách dùng Hermes Agent và trang hướng dẫn Hermes Agent. Người dùng DeepSeek có thể tham khảo trang hướng dẫn DeepSeek.
Toàn bộ bài về nhóm công cụ này được tổng hợp tại tổng hợp bài về AI Agent Skills trên blog.
Lỗi thường gặp khi cài skill cho Claude Code và cách sửa là gì?
Phần lớn lỗi đến từ ba nguyên nhân: Claude Code chưa nằm trên PATH, lệnh được chạy sai shell, hoặc file nằm sai thư mục. Bảng dưới liệt kê các lỗi hay gặp nhất và cách xử lý.
| Thông báo lỗi | Nguyên nhân thường gặp | Cách sửa |
|---|---|---|
claude: command not found hoặc “not recognized” |
Thư mục cài đặt chưa nằm trên PATH | Mở terminal mới. Nếu vẫn lỗi, làm theo mục Fix your PATH trong tài liệu cài đặt chính thức |
The token '&&' is not a valid statement separator |
Bạn đang ở PowerShell, không phải CMD | Mở Git Bash hoặc WSL rồi chạy lại lệnh cài skill |
syntax error near unexpected token '<', lỗi 403 khi cài Claude Code |
Lệnh cài Claude Code không tải được | Xem mục Troubleshoot installation trong tài liệu chính thức để chọn cách cài khác |
| curl báo lỗi HTTP như 404 | Đường dẫn hoặc mã id bị gõ sai | Copy lại lệnh từ trang skill, giữ nguyên mã id |
| Skill không hiện khi gõ / | File nằm sai thư mục hoặc phiên chưa nạp lại | Chạy lại lệnh find, đảm bảo file nằm trong ~/.claude/skills, rồi mở phiên mới |
Chỉ cài skill từ nguồn bạn tin cậy, và đọc file SKILL.md trước khi dùng, vì skill có thể hướng dẫn Claude chạy lệnh trên máy bạn. Nếu bạn cần quản lý biến môi trường an toàn, skill varlock-claude-skill hướng tới việc giảm nguy cơ lộ bí mật trong phiên Claude, terminal, log hoặc git commit.
Khi đã nắm cách cài skill cho claude code, mỗi skill mới chỉ cần lặp lại hai lệnh cài và bước kiểm tra. Nên cài từng skill một rồi kiểm tra ngay, để nếu có lỗi bạn biết nguyên nhân nằm ở bước nào.
Thử ngay: Mở trang hướng dẫn Claude Code trên kho skill để chọn skill phù hợp và cài đúng thư mục ~/.claude/skills. Kho miễn phí, có hơn 4.000 skill, và mỗi skill cài bằng một lệnh. Trang hướng dẫn Claude Code
Câu hỏi thường gặp
Cài skill cho Claude Code có cần chạy lệnh trong terminal không?
Có, cách nhanh nhất là chạy một lệnh trong terminal để tạo thư mục ~/.claude/skills và giải nén skill vào đó. Nếu bạn chưa quen terminal, hãy xem terminal guide trong tài liệu chính thức của Claude Code để biết cách mở terminal và dán lệnh. Sau khi cài, kiểm tra bằng lệnh find hoặc gõ / trong Claude Code.
Skill cài xong có tự chạy không?
Không chạy liên tục. Claude dùng skill khi thấy liên quan đến yêu cầu của bạn, hoặc bạn gọi trực tiếp bằng /tên-skill. Theo tài liệu chính thức, nội dung đầy đủ của skill chỉ được nạp khi skill được dùng, nên tài liệu dài không chiếm chỗ cho đến khi cần.
Cách cài skill cho claude code trên Windows có khác macOS không?
Lệnh gần như giống nhau, nhưng trên Windows bạn nên chạy trong Git Bash hoặc WSL. PowerShell không hiểu dấu && theo kiểu bash, và ký hiệu ~ có thể không hoạt động như mong đợi trong CMD. Git for Windows được tài liệu chính thức khuyến nghị để Claude Code dùng Bash tool.
Vì sao lệnh báo lỗi “The token ‘&&’ is not a valid statement separator”?
Lỗi này xuất hiện khi bạn chạy lệnh trong PowerShell, vì PowerShell không dùng && như bash. Cách sửa là mở Git Bash hoặc WSL rồi chạy lại lệnh cài skill. Theo tài liệu cài đặt của Claude Code, thông báo này cho biết bạn đang ở PowerShell chứ không phải CMD.
Có nên cài nhiều skill cùng lúc không?
Nên cài từng skill một rồi kiểm tra, vì như vậy bạn dễ tìm ra nguyên nhân khi có lỗi. Theo tài liệu chính thức, nội dung skill chỉ nạp khi được dùng, nên việc có nhiều skill không làm nội dung của chúng tải sẵn vào mọi phiên. Bạn có thể chạy /doctor định kỳ để xem skill nào chưa được dùng.