Claude Code, Codex và OpenCode đều nạp skill theo cùng một định dạng: một thư mục chứa tệp SKILL.md. Định dạng này là chuẩn mở Agent Skills, do Anthropic tạo ra và trở thành dự án của Linux Foundation vào ngày 4 tháng 11 năm 2026. Vì vậy, một skill có thể chạy được trong cả ba công cụ. Vấn đề là mỗi công cụ tìm ở những thư mục khác nhau, và có những trường chỉ Claude Code hiểu. Hướng dẫn này cho biết mỗi công cụ tìm ở đâu, cách giữ một bản duy nhất mà cả ba đều nạp, những gì không mang sang được, và cách Orkas cung cấp cùng một bộ skill cho mọi agent lập trình mà nó chạy.
Câu trả lời ngắn gọn: hãy để mỗi thư mục skill trong ~/.agents/skills. Codex và OpenCode đã đọc thư mục này. Claude Code thì không, nên hãy thêm một liên kết tới từng skill trong ~/.claude/skills. Chỉ giữ name và description trong frontmatter, và đặt tên mỗi skill giống tên thư mục của nó. Đã kiểm tra ngày 8 tháng 11 năm 2026 với Claude Code 2.1.319, Codex 0.167.0 và OpenCode 2.2.6.
Claude Code, Codex và OpenCode tìm skill ở đâu
| Thư mục | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | Không | Có | Có |
.agents/skills trong dự án | Không | Có | Có |
~/.claude/skills | Có | Không | Có |
.claude/skills trong dự án | Có | Không | Có |
~/.codex/skills | Không | Có, nhưng đã lỗi thời | Không |
~/.config/opencode/skills, .opencode/skills | Không | Không | Có |
| Cách gọi một skill | /skill-name | $skill-name hoặc /skills | @skill-name |
Cả ba cũng tự chọn một skill khi yêu cầu của bạn khớp với mô tả của nó. Với thư mục dự án, mỗi công cụ kiểm tra thư mục nơi bạn khởi động nó và mọi thư mục cha cho đến gốc của repository.
- Claude Code là công cụ không tìm thấy
.agents/skills. Tài liệu về skill của Claude Code chỉ liệt kê các thư mục.claude, và tài liệu về bộ nhớ nói rằng nó không đọc “bất cứ thứ gì nằm trong thư mục.agents/”. Yêu cầu thay đổi điều này, issue #31005, vẫn đang mở với hơn 450 lượt upvote. - Codex đã chuyển sang
.agents/skills. Tài liệu của Codex liệt kê.agents/skillstrong dự án,~/.agents/skillscho bạn và/etc/codex/skillscho quản trị viên. Thư mục cũ~/.codex/skillsđược đánh dấu lỗi thời trong mã nguồn nhưng vẫn được nạp. Codex không đọc bất kỳ thư mục.claudenào. - OpenCode đọc tất cả. Tài liệu của OpenCode liệt kê các thư mục riêng của nó cùng với
.claude/skillsvà.agents/skills, ở cả hai cấp. Điều này đúng với dòng 2.2 và cả dòng 1.19, dòng vẫn đang tiếp tục được phát hành.
Thiết lập một thư mục dùng chung
Dùng ~/.agents/skills làm bản gốc duy nhất. Codex và OpenCode đọc nó mà không cần thiết lập gì, và cả npx skills lẫn trình nhập của Codex đều ghi vào đó. Sau đó Claude Code nhận một liên kết tới từng skill.
- Chuyển các skill của bạn vào
~/.agents/skills. Với mỗi skill bạn đã viết trong~/.claude/skillshoặc~/.codex/skills, hãy chuyển thư mục của nó, ví dụmv ~/.claude/skills/release-notes ~/.agents/skills/. Để nguyên~/.claude/skills/synced: Claude Code giữ các skill từ tài khoản claude.ai của bạn ở đó. - Liên kết từng skill vào thư mục của Claude Code. Trên macOS hoặc Linux, hãy chạy đoạn sau. Nó bỏ qua mọi skill đã có thư mục hoặc liên kết ở đó.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
n=$(basename "$d")
[ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done- Trên Windows, hãy dùng junction. Junction không cần quyền admin. Trong PowerShell:
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
$link = "$HOME\.claude\skills\$($_.Name)"
if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}- Kiểm tra từng công cụ. Mở một phiên mới. Trong Claude Code, gõ
/và tìm skill. Trong Codex, chạy/skills. Trong OpenCode, gõ@.
Với dự án mà cả nhóm dùng chung, hãy làm tương tự bên trong repository: giữ skill trong .agents/skills và liên kết từng skill từ .claude/skills bằng một liên kết tương đối, chẳng hạn ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.
Vài điểm cần làm đúng:
- Liên kết từng skill, không liên kết cả thư mục. Nếu bản thân
~/.claude/skillstrỏ tới~/.agents/skills, các thư mụcsyncedvà.trashcủa Claude Code sẽ nằm trong thư mục dùng chung, và Codex cùng OpenCode có thể nạp luôn cả các skill đã đồng bộ. Cái giá phải trả là bạn cần chạy lại vòng lặp sau khi thêm một skill. - Liên kết thư mục, không liên kết tệp SKILL.md. Codex đi theo một thư mục skill được liên kết, nhưng bỏ qua một SKILL.md mà bản thân nó là liên kết. OpenAI đã đóng yêu cầu đó với lý do không có kế hoạch thực hiện.
- Đừng commit liên kết nếu có đồng đội dùng Windows. Theo mặc định, Git for Windows checkout liên kết thành các tệp văn bản nhỏ. Hãy tạo liên kết bằng một script thiết lập, hoặc commit bản sao thật.
- OpenCode thấy mỗi skill hai lần và giữ lại một. Nó đọc cả liên kết trong
~/.claude/skillslẫn thư mục trong~/.agents/skills. Phiên bản 2.2 lặng lẽ gộp chúng lại. Phiên bản 1.19 ghi một cảnh báo trùng lặp vào log; hãy đặtOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1để OpenCode ngừng đọc các thư mục Claude.
Viết một skill cả ba đều nạp được
SKILL.md này được nạp theo cùng một cách trong Claude Code, Codex và OpenCode. Nó nằm ở ~/.agents/skills/release-notes/SKILL.md, bên cạnh là một thư mục references và một thư mục scripts.
---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---
# Ghi chú phát hành
1. Tìm tag gần nhất: git describe --tags --abbrev=0
2. Liệt kê các commit kể từ tag đó: git log <tag>..HEAD --oneline --no-merges
3. Nhóm các commit thành Added, Changed và Fixed, theo references/format.md trong thư mục của skill này.
4. Để lưu thành tệp, chạy scripts/write_notes.sh từ thư mục của skill này.- Đặt tên skill giống tên thư mục của nó. Dùng chữ thường, chữ số và dấu gạch nối, tối đa 64 ký tự. Codex dựa vào
name, OpenCode 2.2 dựa vào tên thư mục, còn Claude Code chấp nhận cả hai. Nếu hai tên khác nhau, bạn sẽ gọi cùng một skill bằng những tên khác nhau trong mỗi công cụ. Codex bỏ qua skill có tên dài hơn 64 ký tự. - Giữ mô tả dưới 1.024 ký tự và đặt những từ mà mọi người sẽ dùng lên đầu. Đó là giới hạn của chuẩn, và Codex cắt các mô tả dài hơn xuống độ dài đó trong danh sách skill của nó.
- Đặt trong dấu ngoặc kép mọi giá trị có dấu hai chấm theo sau là dấu cách. Nếu không, frontmatter có thể không parse được. Codex sửa được hầu hết các trường hợp này, Claude Code nạp skill như thể nó không có frontmatter, còn OpenCode có thể bỏ qua skill mà không báo lỗi.
- Cho script tự tìm thư mục của chính nó. Các công cụ chạy lệnh từ thư mục dự án của bạn, không phải từ thư mục của skill. Một script bắt đầu bằng
cd "$(dirname "$0")"sẽ chạy được từ bất cứ đâu. - Đừng đưa “claude” vào tên nếu bạn có thể sẽ tải skill lên claude.ai hoặc Claude API. Cả hai đều từ chối tên có chứa “claude” hoặc “anthropic”.
Những gì không mang sang được từ Claude Code
Codex chỉ đọc name, description và một mô tả ngắn trong metadata. OpenCode 2.2 đọc thêm metadata và disable-model-invocation. Cả hai bỏ qua mọi trường khác mà không báo lỗi, nên một skill của Claude Code vẫn nạp được nhưng hoạt động khác đi.
| Trong skill của Claude Code | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | Hoạt động | Bị bỏ qua | Bị bỏ qua |
disable-model-invocation: true | Hoạt động | Bị bỏ qua; dùng agents/openai.yaml | Hoạt động |
context: fork, agent, model, hooks, argument-hint | Hoạt động | Bị bỏ qua | Bị bỏ qua |
$ARGUMENTS và $1 trong nội dung | Được thay bằng đối số của bạn | Giữ nguyên dạng văn bản | Giữ nguyên dạng văn bản |
!`command` trong nội dung | Chạy trước khi Claude đọc skill | Giữ nguyên dạng văn bản | Giữ nguyên dạng văn bản |
${CLAUDE_SKILL_DIR} | Được thay bằng thư mục của skill | Giữ nguyên dạng văn bản | Giữ nguyên dạng văn bản |
- Viết các bước chạy được mà không cần những tính năng này. Hãy viết “chạy scripts/check.sh từ thư mục của skill này” thay vì dùng
${CLAUDE_SKILL_DIR}, và hỏi những thông tin còn thiếu bằng lời lẽ đơn giản thay vì dùng$ARGUMENTS. Claude Code vẫn làm theo các chỉ dẫn đó bình thường. - Để Codex không tự gọi một skill, hãy thêm
agents/openai.yamlvào thư mục skill vớiallow_implicit_invocation: falsetrongpolicy. Bạn vẫn có thể gọi skill đó bằng$skill-name. allowed-toolskhông giới hạn những gì Codex hay OpenCode có thể làm. Bảng tương thích củanpx skillsghi là cả hai đều hỗ trợ trường này, nhưng trình nạp skill của cả hai công cụ đều không đọc nó. Hãy đặt giới hạn trong phần cài đặt quyền riêng của từng công cụ.
Công cụ cài skill cho nhiều agent
| Công cụ | Cách chia sẻ skill | Cần lưu ý |
|---|---|---|
npx skills (Vercel, 38.500 sao) | Sao chép skill vào .agents/skills và liên kết thư mục của từng agent tới đó. Dùng junction trên Windows. --copy tạo các bản sao riêng. | Cùng cấu trúc với hướng dẫn này. Chạy npx skills add owner/repo, thêm -g cho thư mục người dùng của bạn. |
| skillshare (2.900 sao) | Giữ một thư mục nguồn và liên kết nó vào thư mục của từng công cụ; dùng junction trên Windows. | Cập nhật ngày 6 tháng 11 năm 2026. Cài bằng Homebrew hoặc một shell script. |
Codex /import | Sao chép skill từ .claude/skills vào .agents/skills. | Các bản sao dần lệch khỏi bản gốc. Nó còn đổi “claude” thành “Codex” trong nội dung, kể cả bên trong đường dẫn tệp (issue #40147 đang mở). |
| openskills (10.800 sao) | Sao chép skill vào .claude/skills và liệt kê chúng trong AGENTS.md. | Không có bản phát hành nào kể từ tháng 1 năm 2026. Tùy chọn --universal ghi vào .agent/skills, thư mục mà cả ba công cụ đều không đọc. |
Còn CLAUDE.md và AGENTS.md thì sao?
Codex và OpenCode đọc AGENTS.md, và OpenCode chuyển sang dùng CLAUDE.md khi dự án không có AGENTS.md. Từ phiên bản 2.1.277, Claude Code cũng đọc AGENTS.md, nhưng chỉ trong dự án không có CLAUDE.md hoặc CLAUDE.local.md. Nếu bạn giữ cả hai tệp, hãy mở /config trong Claude Code và đặt Project instructions để nạp cả hai. Hãy đặt các quy tắc mà mọi agent cần tuân theo vào AGENTS.md, và giữ CLAUDE.md cho những gì chỉ Claude Code cần.
Dùng cùng bộ skill từ Orkas
Orkas là một ứng dụng desktop chạy Claude Code, Codex, OpenCode, OpenClaw và Hermes như các agent trong cùng một cuộc trò chuyện. Nó dùng các bản đã cài trên máy tính của bạn và thông tin đăng nhập của chính bạn. Đây là cách skill của bạn đến được các agent đó.
- Thư mục dùng chung vẫn hoạt động. Mỗi CLI vẫn đọc các thư mục skill của riêng nó khi Orkas khởi động nó, nên cách thiết lập ở trên vẫn chạy mà không cần thay đổi. Orkas thêm MCP server của riêng mình bên cạnh các server của bạn chứ không thay thế chúng.
- Skill bạn thêm trong Orkas đến được mọi CLI. Mọi CLI mà Orkas khởi động đều nhận được một MCP server tên là
orkas. Server này liệt kê các skill Orkas của bạn, nạp một skill khi tác vụ phù hợp, và chạy các script đi kèm skill đó. Hãy yêu cầu Claude Code dùng một skill theo tên, hoặc để nó tự tìm skill phù hợp. - Orkas cũng đọc skill Claude Code và Codex của bạn. Các skill trong
~/.claude/skillsvà~/.codex/skillsxuất hiện trong Kỹ năng ▸ Thư mục toàn cục, và Commander có thể dùng chúng trong các tác vụ của chính nó. Orkas chỉ đọc các thư mục này và không bao giờ thay đổi chúng. Orkas không đọc trực tiếp~/.agents/skills, nên với cách thiết lập ở trên, nó tìm thấy skill của bạn qua các liên kết trong~/.claude/skills.
Để thêm một gói skill từ GitHub, hãy dán liên kết repository vào cuộc trò chuyện với Commander và yêu cầu nó cài gói đó. Nếu gói cần cài phụ thuộc, Orkas sẽ hỏi bạn trước. Các skill xuất hiện trong Kỹ năng ▸ Gói bên ngoài. Từ đó trở đi, Claude Code, Codex và OpenCode đều dùng được chúng khi bạn chạy chúng từ Orkas, mà không phải sao chép gì vào ba thư mục. Để bắt đầu, hãy chọn Kết nối tác tử trên thanh bên và chọn các CLI bạn đã cài. Để xem hướng dẫn đầy đủ về cách chạy song song hai công cụ, hãy xem Cách chạy Claude Code và Codex cùng nhau.
Nên chọn cách thiết lập nào?
| Tình huống của bạn | Hãy làm thế này |
|---|---|
| Bạn dùng hai hoặc ba công cụ này trên một máy tính | Giữ skill trong ~/.agents/skills và liên kết từng skill vào ~/.claude/skills |
| Nhóm chia sẻ skill trong một repository | Commit .agents/skills; tạo các liên kết .claude/skills bằng script thiết lập |
| Bạn thường cài skill từ GitHub | npx skills add, công cụ thiết lập sẵn các liên kết đó cho bạn |
| Bạn chỉ dùng Claude Code và OpenCode | Tiếp tục dùng ~/.claude/skills; OpenCode đã đọc thư mục này |
| Bạn chạy các CLI từ Orkas | Cài gói skill một lần trong Orkas; mọi CLI mà Orkas khởi động đều dùng được |
Câu hỏi
Tôi có thể dùng skill của Claude trong Codex không?
Có. Codex đọc cùng định dạng SKILL.md, nhưng tìm trong ~/.agents/skills và .agents/skills, không phải trong ~/.claude/skills. Hãy chuyển các thư mục skill sang đó rồi liên kết ngược lại cho Claude Code, hoặc chạy /import trong Codex để sao chép chúng. Các trường như allowed-tools và tính năng như $ARGUMENTS chỉ hoạt động trong Claude Code.
OpenCode có đọc skill của Claude Code không?
Có. OpenCode đọc ~/.claude/skills và .claude/skills cũng như ~/.agents/skills và các thư mục riêng của nó, nên skill của Claude Code xuất hiện mà không cần thiết lập gì. Để tắt việc này, hãy đặt OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.
Claude Code có đọc .agents/skills không?
Không. Tính đến tháng 11 năm 2026, Claude Code chỉ đọc skill từ các thư mục .claude, và tài liệu của nó nói rằng nó bỏ qua mọi thứ trong thư mục .agents. Yêu cầu bổ sung việc này, issue #31005, vẫn đang mở. Trong lúc chờ, hãy liên kết từng skill từ ~/.claude/skills.
Vì sao Codex không thấy skill tôi đã liên kết?
Codex đi theo một thư mục skill được liên kết, nhưng bỏ qua tệp SKILL.md mà bản thân nó là liên kết. Thay vào đó, hãy liên kết cả thư mục. Liên kết tương đối được phân giải từ thư mục chứa liên kết, nên hãy kiểm tra xem đường dẫn có đúng khi tính từ đó không.
Vì sao một skill xuất hiện hai lần?
Thường là vì có hai bản sao nằm trong các thư mục mà công cụ đọc. Codex vẫn đọc thư mục cũ ~/.codex/skills cùng với ~/.agents/skills, và liệt kê cả hai bản sao của một skill có cùng tên. Hãy giữ một bản trong ~/.agents/skills và xóa bản còn lại.
Để so sánh ba công cụ ngoài phạm vi skill, hãy xem Claude Code, Codex và OpenCode.