Cách đồng bộ kỹ năng cho Claude Code, Codex, Cursor và OpenCode

Mỗi công cụ tìm kỹ năng ở đâu

Theo tài liệu của từng công cụ, đọc ngày 4 tháng 11 năm 2026. Mỗi thư mục chứa một thư mục con cho mỗi kỹ năng, bên trong có SKILL.md.

Hai thư mục là đủ cho cả bốn: ~/.claude/skills (Claude Code, Cursor, OpenCode) và ~/.agents/skills (Codex, Cursor, OpenCode).

Một bản trên máy của bạn: symlink

Giữ các tệp thật trong một thư mục và trỏ cả hai vị trí về đó. Trên macOS hoặc Linux:

mkdir -p ~/skills
# move existing skills in first, then:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

Nếu một trong hai thư mục đã tồn tại, hãy chuyển nội dung của nó vào ~/skills và xóa thư mục trống trước khi tạo liên kết. Cursor và OpenCode đọc cả hai vị trí, nên chúng đến cùng các tệp qua hai đường dẫn. Nếu công cụ nào hiện một kỹ năng hai lần, đó vẫn là một tệp: chỉ cần sửa một lần trong ~/skills.

Với một repo, làm tương tự với .claude/skills và .agents/skills, commit thư mục thật, và mọi người clone repo đều nhận được các kỹ năng.

Một bản cho cả nhóm: máy chủ MCP

Symlink và repo phù hợp với lập trình viên. Chúng không đến được đồng đội làm việc trong Claude hay ChatGPT trên trình duyệt, và cần git pull để cập nhật. Cả bốn agent lập trình cũng kết nối được với máy chủ MCP từ xa:

• Claude Code: claude mcp add --transport http <name> <url>
• Codex: một mục máy chủ có url = "…" trong tệp cấu hình (Streamable HTTP).
• Cursor: một máy chủ Streamable HTTP trong phần cài đặt MCP.
• OpenCode: một máy chủ có "type": "remote" trong tệp cấu hình.

Một máy chủ chứa kỹ năng của nhóm sẽ cho các agent lập trình, Claude và ChatGPT cùng một bản hiện tại, không cần pull hay liên kết lại gì.

Kiểm tra công cụ đã thấy kỹ năng của bạn chưa

1. Kiểm tra cấu trúc: <folder>/<skill-name>/SKILL.md, với thư mục có tên giống trường name.
2. Kiểm tra frontmatter: name gồm chữ thường, chữ số và dấu gạch nối, tối đa 64 ký tự, và một description không để trống. Công cụ chuyển đổi SKILL.md viết cả hai.
3. Bắt đầu một phiên mới và hỏi agent nó có những kỹ năng nào, hoặc yêu cầu đúng việc mà mô tả nêu ra.

Câu hỏi thường gặp

Làm sao đồng bộ kỹ năng của Claude Code với Claude Desktop và claude.ai?

Claude Code đọc thư mục trên ổ đĩa; Claude Desktop và claude.ai giữ kỹ năng đã tải lên trong tài khoản của bạn. Tải cùng thư mục đó lên dưới dạng ZIP trong Customize > Skills, hoặc kết nối cả hai với một máy chủ MCP phục vụ các kỹ năng.

Vì sao Claude Code không thấy thư mục .agents/skills của tôi?

Claude Code đọc ~/.claude/skills và .claude/skills, không đọc .agents/skills. Hãy liên kết thư mục vào ~/.claude/skills, như các bước tạo symlink ở trên.