cách cài skill cho codex là đặt thư mục skill (có file SKILL.md) vào ~/.codex/skills để Codex CLI đọc và dùng được quy trình trong đó. Bạn chỉ cần chạy một lệnh curl kèm tar để giải nén skill, sau đó mở Codex và gõ /skills để kiểm tra.
Cập nhật: 31/10/2026
Tóm tắt nhanh
- Skill cho Codex là một thư mục chứa file SKILL.md, trong đó có tên, mô tả và hướng dẫn cho một quy trình cụ thể.
- Codex CLI đọc skill từ thư mục ~/.codex/skills, nên bạn cần giải nén skill vào đúng thư mục này.
- Lệnh cài gồm hai phần: tạo thư mục bằng mkdir -p, rồi tải và giải nén file .tgz của skill bằng curl và tar.
- Sau khi cài, bạn gõ /skills trong Codex CLI để xem danh sách skill đã được nhận.
- Để gọi skill, bạn gõ dấu $ và tên skill, ví dụ $codex-review.
- Khi skill không hoạt động, nguyên nhân thường là sai thư mục, thiếu file SKILL.md hoặc chưa mở lại Codex CLI.
Cách cài skill cho Codex cần chuẩn bị gì?
Bạn cần Codex CLI đã được cài trên máy và một terminal để chạy lệnh. Theo trang tài liệu chính thức, Codex CLI trên macOS và Linux được cài bằng lệnh curl -fsSL https://chatgpt.com/codex/install.sh | sh.
Trang tài liệu Codex CLI cũng có hướng dẫn cho Windows, npm và Homebrew. Lệnh tải skill trong bài này dùng curl và tar, nên trên Windows bạn nên chạy trong Git Bash hoặc WSL. Nếu bạn cần cài thêm công cụ khác trên Windows, xem hướng dẫn cài Claude Code trên Windows để làm quen với môi trường dòng lệnh.
Nếu bạn chưa rõ skill khác gì so với một đoạn prompt thông thường, hãy đọc skill Claude là gì trước. Codex CLI dựa trên chuẩn mở agent skills, nên khái niệm và cấu trúc thư mục khá giống nhau giữa các công cụ.
Cách cài skill cho Codex: các bước thực hiện
Bạn tạo thư mục skill, rồi tải và giải nén gói .tgz của skill vào đó bằng một lệnh duy nhất. Với Codex CLI, thư mục đích là ~/.codex/skills.
- Cài Codex CLI bằng lệnh chính thức, sau đó mở terminal và kiểm tra lệnh
codexchạy được.curl -fsSL https://chatgpt.com/codex/install.sh | sh - Chạy lệnh cài skill. Ví dụ dưới đây cài skill codex-review:
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/codex-review-4d7df.tgz | tar xz -C ~/.codex/skills - Kiểm tra file SKILL.md đã nằm trong thư mục skill:
find ~/.codex/skills -name SKILL.md - Thoát và mở lại Codex CLI, rồi gõ /skills để xem danh sách skill.
Để cài skill khác, bạn chỉ cần thay id trong URL, giữ nguyên phần mkdir và tar. Ví dụ, skill migrate-to-codex có id migrate-to-codex-7820b, và lệnh cài của nó dùng đúng cấu trúc trên.
Lệnh cài skill cho Codex trên một dòng
Lệnh cài chuẩn có dạng mkdir -p thư mục rồi curl tải file .tgz và tar giải nén vào cùng thư mục đó. Thư mục đích cho Codex CLI là ~/.codex/skills, còn id nằm sau đường dẫn /z/ trong URL của từng skill.
Thử ngay: Kho skill có hơn 4.000 skill miễn phí, và mỗi skill có lệnh cài một dòng cho Codex. Bạn có thể mở trang hướng dẫn Codex để xem đúng thư mục và cách gọi skill.
Làm sao biết Codex đã nhận skill vừa cài?
Lệnh /skills trong Codex CLI là cách kiểm tra trực tiếp nhất: nếu tên skill hiện trong danh sách, Codex đã đọc được skill. Bạn gõ /skills trong phiên làm việc và tìm tên skill vừa cài.
Codex CLI đọc tên và mô tả của mọi skill ngay từ đầu, còn nội dung đầy đủ của SKILL.md chỉ được nạp khi Codex chọn dùng skill đó. Vì vậy, nếu skill không xuất hiện trong /skills, nguyên nhân thường nằm ở thư mục hoặc ở file SKILL.md, không phải ở nội dung hướng dẫn. File SKILL.md bắt buộc phải có name và description.
Gọi skill trong Codex bằng cách nào?
Trong Codex CLI, bạn gọi skill bằng dấu $ theo sau tên skill, ví dụ $codex-review. Ngoài ra, Codex có thể tự chọn skill khi yêu cầu của bạn khớp với phần mô tả của skill đó.
Cách gọi này khác với Claude Code và Hermes Agent, nơi bạn gõ /tên-skill. Bảng dưới đây tổng hợp thư mục và cách gọi cho các công cụ có trong kho skill.
| Công cụ | Thư mục skill | Cách gọi skill | Trang hướng dẫn |
|---|---|---|---|
| Codex CLI | ~/.codex/skills | $tên-skill | Codex |
| Claude Code | ~/.claude/skills | /tên-skill | Claude Code |
| Hermes Agent | ~/.hermes/skills | /tên-skill | Hermes Agent |
| DeepSeek (Deep Code CLI) | ~/.deepcode/skills | Xem trang hướng dẫn | DeepSeek |
Nếu bạn dùng Hermes Agent song song với Codex, hãy đọc cách dùng Hermes Agent để nắm quy tắc gọi lệnh của công cụ này. Dấu $ và dấu / không thể thay thế cho nhau, nên nhớ đúng công cụ trước khi gõ.
Lỗi thường gặp khi cài skill cho Codex và cách sửa?
Phần lớn lỗi đến từ sai thư mục đích, file SKILL.md nằm sai chỗ hoặc gõ sai tên skill. Bạn kiểm tra theo thứ tự dưới đây trước khi cài lại.
- Thư mục ~/.codex/skills chưa tồn tại: lệnh mkdir -p trong bài sẽ tự tạo thư mục này, nên bạn chỉ cần chạy lại đúng một dòng lệnh.
- Skill không hiện trong /skills: chạy find ~/.codex/skills -name SKILL.md để xem file có nằm trong thư mục con không, rồi thoát và mở lại Codex CLI.
- $tên-skill không hoạt động: kiểm tra lại tên skill trong /skills, vì tên phải đúng từng ký tự, kể cả đuôi id như -4d7df.
- Một số skill biến mất khỏi danh sách: Codex giới hạn danh sách skill ban đầu ở khoảng 2% cửa sổ ngữ cảnh, hoặc 8.000 ký tự khi không biết kích thước cửa sổ. Khi cài quá nhiều skill, Codex có thể rút ngắn mô tả hoặc bỏ bớt skill; bạn có thể đặt skills.max_context_tokens lên tối đa 10.000 token.
- Skill đã cài cho Claude Code nhưng Codex không thấy: hai công cụ dùng thư mục khác nhau. Bạn cần cài lại vào ~/.codex/skills, hoặc tham khảo cách cài skill cho Claude Code để kiểm tra cấu hình bên Claude.
Ví dụ: cài và dùng skill codex-review như thế nào?
Skill codex-review dùng để đánh giá mã chuyên nghiệp, tự động tạo CHANGELOG và review các đợt refactoring quy mô lớn. Bạn cài skill này bằng lệnh ở phần các bước, rồi mở Codex CLI trong thư mục dự án.
- Trong terminal, chuyển vào thư mục dự án và chạy
codex. - Gõ $codex-review cùng yêu cầu cụ thể, ví dụ: $codex-review kiểm tra các thay đổi chưa commit trong dự án này.
- Đọc kết quả Codex đưa ra và tự kiểm tra từng chỗ trước khi áp dụng thay đổi.
Nếu bạn muốn giao một việc có phạm vi giới hạn cho Codex như một tác vụ độc lập, xem skill codex-subagent. Skill codex-profiles phù hợp khi bạn cần tách các CODEX_HOME riêng cho tài khoản và dự án khác nhau.
Người đang chuyển từ Claude Code sang Codex có thể dùng skill migrate-to-codex để di chuyển các file hướng dẫn, skill, agent và cấu hình MCP được hỗ trợ sang file dự án và file toàn cục của Codex. Nếu muốn xem ví dụ về cách viết một skill giao diện, đọc bài skill Claude frontend design. Bạn cũng có thể xem tổng hợp bài về AI Agent Skills để chọn thêm chủ đề phù hợp.
Khi bạn đã nắm cách cài skill cho Codex, phần còn lại là chọn đúng skill cho từng việc và gọi bằng đúng dấu $. Mỗi skill chỉ cần cài một lần vào thư mục ~/.codex/skills.
Thử ngay: Bạn sẽ nhận được lệnh cài một dòng cho từng skill, miễn phí, trong kho có hơn 4.000 skill. Bắt đầu tại danh mục Agent tự động hóa để chọn skill cho công việc của bạn.
Câu hỏi thường gặp
Skill cho Codex khác gì so với prompt thông thường?
Skill là một thư mục đóng gói hướng dẫn, tài nguyên và script tùy chọn, được gắn với file SKILL.md. Codex chỉ đọc tên và mô tả của skill lúc đầu, rồi nạp toàn bộ hướng dẫn khi chọn dùng, nên bạn không phải dán lại cùng một đoạn prompt dài mỗi lần làm việc.
Cài skill cho Codex vào thư mục nào?
Bạn cài skill cho Codex CLI vào thư mục ~/.codex/skills. Nếu thư mục chưa có, lệnh mkdir -p trong bước cài sẽ tự tạo, sau đó tar giải nén skill vào đó.
Có thể để Codex tự chọn skill mà không cần gõ tên không?
Có. Codex có thể tự chọn skill khi yêu cầu của bạn khớp với phần mô tả trong SKILL.md. Vì vậy, mô tả rõ ràng và có từ khóa đúng sẽ giúp Codex chọn đúng skill hơn.
Skill đã cài cho Claude Code có dùng được cho Codex không?
Không tự động. Claude Code và Codex đọc skill từ hai thư mục khác nhau, nên bạn cần cài lại vào ~/.codex/skills. Với các file được hỗ trợ, bạn có thể dùng skill migrate-to-codex để chuyển sang file dự án và file toàn cục của Codex.
Gọi skill trong Codex khác Claude Code như thế nào?
Trong Codex CLI, bạn gọi skill bằng dấu $ theo sau tên skill, ví dụ $codex-review. Claude Code và Hermes Agent dùng dấu /, nên bạn cần nhớ đúng ký hiệu của từng công cụ để tránh gọi nhầm lệnh.