Chọn cách cài theo công cụ bạn dùng: ứng dụng chat như ChatGPT, Claude nhận tệp tải về, agent lập trình như Claude Code, Codex cài bằng một lệnh. Cài không cần tài khoản SePay. Skill được và không được làm gì xem ở Bảo mật của SePay Skills.
Cài SePay Skills vào ứng dụng chat AI
Claude, ChatGPT, Gemini và Grok nhận cùng một tệp sepay.zip. Tệp luôn là bản mới nhất từ repo chính thức sepayvn/sepay-skills. Tải lên nguyên tệp zip, không giải nén.
Tên menu bên dưới ghi theo giao diện tháng 11/2026 và có thể đổi theo phiên bản.
Cài SePay Skills vào Claude
- Chọn ảnh đại diện ở góc dưới bên trái.
- Chọn Cài đặt (Settings).

Trong cửa sổ Cài đặt:
- Ở menu bên trái, chọn Skills.
- Chọn Thêm (Add).
- Chọn Tải Skill lên (Upload skill).

Ở trang Tải Skill lên (Upload a skill):
- Kéo thả hoặc chọn tệp
sepay.zip, tệp hiện ở mục Tệp Skill (Skill file). - Chọn Tải lên (Upload). Claude bật skill ngay sau khi tải lên.

Tải lên xong, Claude mở trang skill sepay:
- Công tắc đã bật, skill dùng được ngay.
- Chọn Thử trong đoạn chat (Try in chat) để hỏi thử.

Bạn cũng mở thẳng được trang Skills của Claude.
Xem thêm hướng dẫn tạo skills trên Claude của AnthropicCài SePay Skills vào ChatGPT
Chỉ gói ChatGPT Plus, Business, Enterprise, Healthcare và Edu thêm được skill.
- Ở thanh bên, chọn Plugin (Plugins).
- Chọn tab Kỹ năng (Skills).
- Chọn Thêm (Create) ở góc trên bên phải, rồi chọn Tải lên từ máy tính (Upload from your computer).
Trong hộp thoại Tải kỹ năng lên:
- Kéo
sepay.zipvào khung tải lên, hoặc bấm vào khung để chọn tệp. - Hộp thoại báo Đã tải kỹ năng lên thì chọn Xong.
Skill sepay hiện trong mục Đã cài đặt của tab Kỹ năng.
Cài SePay Skills vào Gemini
- Ở thanh bên, chọn Tuỳ chỉnh (Customize). Không thấy mục này thì bấm More trước.
- Chọn tab Kỹ năng (Skills).
- Chọn Tạo (Create).
- Chọn Tải lên (Upload).

Trong hộp thoại Tải kỹ năng lên:
- Kéo
sepay.zipvào khung tải lên, hoặc bấm vào khung để chọn tệp. Hộp thoại chỉ ghi tệp CSV, PY, TXT và MD nhưng vẫn nhậnsepay.zip. - Chọn Tiếp tục.

Gemini hiện tên sepay, mô tả và chỉ dẫn của skill. Chọn Tạo để lưu skill.

Cài SePay Skills vào Grok
Ở thanh bên, chọn Mục Plugin (Plugins).

Trong cửa sổ vừa mở:
- Chọn tab Kỹ năng (Skills).
- Chọn Kỹ năng mới.
- Chọn Tải lên tệp kỹ năng, rồi chọn
sepay.zip.

Bạn cũng mở thẳng được trang Skills của Grok.
Xem thêm hướng dẫn tạo skills trên Grok của xAIThử SePay Skills trong ứng dụng chat
Mở một cuộc trò chuyện mới rồi hỏi việc bạn cần làm với cửa hàng, ví dụ:
tôi muốn tích hợp xác thực thanh toán tự động cho cửa hàng online của tôi
Với Claude:
- Claude hiện Loaded skill sepay khi nạp skill, rồi đọc thêm hướng dẫn chọn cách tích hợp trong skill.
- Claude hỏi cửa hàng của bạn chạy trên nền tảng nào: WordPress / WooCommerce thì dùng plugin SePay, tự code thì tích hợp webhook và mã QR vào code của bạn.

Chọn câu trả lời đúng với cửa hàng, AI hướng dẫn tiếp từng bước trên my.sepay.vn theo đúng tên nút. Nếu AI trả lời mà không dùng skill, nhắc tên SePay trong câu hỏi.
Cài SePay Skills cho agent lập trình
Claude Code: cài bằng plugin
Mở Claude Code trong thư mục gốc của dự án rồi gõ lệnh sau, không cần Node.js:
> /plugin install sepay --marketplace sepayvn/sepay-skillsClaude Code hỏi có thêm marketplace của SePay từ repo sepayvn/sepay-skills không. Nhấn y:
Add marketplace? To install sepay, add the marketplace that lists it:github:sepayvn/sepay-skills Only add marketplaces you trust. You'll review the plugin and choose where to install it next. Press y to add or n to cancelTiếp theo, chọn nơi cài bằng phím mũi tên rồi nhấn Enter:
- Install for all collaborators on this repository (project scope): cài vào dự án. Commit thư mục
.claudelên là cả nhóm dùng chung, nên chọn mục này khi làm việc theo nhóm. - Install for you (user scope): cài cho bạn, mọi dự án trên máy đều có skill.
- Install for you, in this repo only (local scope): chỉ bạn dùng, chỉ trong dự án này.
Plugin Details SePay Tích hợp SePay: xác nhận chuyển khoản qua webhook, VietQR, tài khoản ảo, cổng thanh toán, SePay API, hóa đơn điện tử, sepay CLI, SePay MCP. By: SePay Install for you (user scope)❯ Install for all collaborators on this repository (project scope)Install for you, in this repo only (local scope)Open homepageBack to plugin listCài xong, Claude Code báo plugin đã bật và dùng được ngay trong phiên đang mở:
> /plugin install sepay --marketplace sepayvn/sepay-skills⎿ ✓ Installed SePay. Plugin is now active.Plugin chỉ cài skill. Muốn Claude Code đọc giao dịch, số dư trong tài khoản SePay, kết nối thêm SePay MCP cho Claude Code.
Đã cài skill bằng npx vào ~/.claude/skills/sepay thì gỡ bản đó trước bằng npx skills remove sepay -g (thêm DISABLE_TELEMETRY=1 trước lệnh nếu không muốn gửi thông tin về skills.sh), để Claude Code không có hai bản skill.
Codex: cài bằng plugin
Chạy trong terminal, không cần mở Codex trước, không cần Node.js:
$ codex plugin marketplace add sepayvn/sepay-skills$ codex plugin add sepay@sepayLệnh đầu thêm marketplace của SePay từ repo sepayvn/sepay-skills, lệnh sau cài plugin sepay. Plugin dùng được cho mọi dự án trên máy. Mở phiên Codex mới để Codex nạp skill.
Hoặc gõ lệnh sau ngay trong Codex, cũng cài skill sepay:
> $skill-installer install https://github.com/sepayvn/sepay-skills/tree/main/skills/sepayCách này đặt skill ở ~/.codex/skills/sepay. Hướng dẫn của OpenAI: Skills trong Codex.
Cursor và agent khác: cài bằng npx
Chạy lệnh có ghi sẵn agent bạn dùng (-a). Lệnh cài cho mọi dự án trên máy (-g) và không hỏi gì thêm (-y):
$ npx skills add sepayvn/sepay-skills -a cursor -g -yNode.js 22.20 trở lên chỉ cần cho lệnh npx skills, công cụ cài skill của bên thứ ba (vercel-labs/skills), không phải yêu cầu của SePay Skills. Cài bằng tệp zip, plugin Claude Code hay $skill-installer của Codex thì không cần Node.js.
Công cụ npx skills gửi tên repo, tên skill và agent bạn chọn về skills.sh, danh mục skill của Vercel, mỗi lần cài hoặc gỡ; bản thân SePay Skills không gửi gì. Muốn tắt, đặt DISABLE_TELEMETRY=1 trước lệnh, ví dụ DISABLE_TELEMETRY=1 npx skills add sepayvn/sepay-skills -a cursor -g -y (Windows PowerShell: chạy $env:DISABLE_TELEMETRY=1 trước).
Muốn skill nằm trong dự án để commit lên cho cả nhóm dùng chung, bỏ -g và chạy trong thư mục gốc của dự án, ví dụ npx skills add sepayvn/sepay-skills -a cursor -y.
| Agent | Giá trị -a | Theo dự án | Toàn máy (-g) |
|---|---|---|---|
| Cursor | cursor | .agents/skills/sepay | ~/.agents/skills/sepay |
| GitHub Copilot | github-copilot | .agents/skills/sepay | ~/.agents/skills/sepay |
| Windsurf | windsurf | .windsurf/skills/sepay | ~/.codeium/windsurf/skills/sepay |
| Gemini CLI | gemini-cli | .agents/skills/sepay | ~/.agents/skills/sepay |
| Cline | cline | .agents/skills/sepay | ~/.agents/skills/sepay |
| Grok Build | grok | .grok/skills/sepay | ~/.grok/skills/sepay |
Agent khác xem ở danh sách agent skills CLI hỗ trợ.
Kiểm tra skill trong agent
Mở phiên mới của agent, vì phiên đang mở chưa thấy skill vừa cài. Nhờ một việc về SePay, ví dụ "Tích hợp SePay webhook bằng PHP để xác nhận đơn hàng khi khách chuyển khoản." Claude Code hiện Skill(sepay) kèm Successfully loaded skill khi nạp skill:

Cập nhật và gỡ SePay Skills
Skill không tự cập nhật. Cài bằng tệp thì tải lại tệp, xóa skill sepay cũ rồi thêm lại. Cài bằng plugin trong Claude Code thì gõ:
> /plugin update sepay@sepayCài bằng plugin trong Codex thì lấy bản mới của marketplace rồi cài lại plugin:
$ codex plugin marketplace upgrade sepay$ codex plugin remove sepay@sepay$ codex plugin add sepay@sepayCài bằng $skill-installer trong Codex thì xóa thư mục ~/.codex/skills/sepay rồi chạy lại lệnh cài, vì lệnh cài dừng lại khi thư mục đã có. Cài bằng npx thì chạy:
$ npx skills update sepayMuốn gỡ, xóa skill sepay trong mục Skills của ứng dụng chat, hoặc xóa thư mục sepay trong thư mục skill của agent (Codex cài bằng $skill-installer: ~/.codex/skills/sepay). Cài bằng plugin thì gõ /plugin uninstall sepay@sepay trong Claude Code, hoặc chạy codex plugin remove sepay@sepay với plugin Codex. Cài bằng npx thì chạy npx skills remove sepay, thêm -g với bản cài toàn máy. Lệnh gỡ cũng gửi tên repo, tên skill và agent về skills.sh của Vercel; muốn tắt thì chạy DISABLE_TELEMETRY=1 npx skills remove sepay.
Lỗi thường gặp
Tiếp theo
- Xem AI làm được những việc gì với skill tại Tổng quan SePay Skills.
- Cho AI đọc dữ liệu tài khoản khi gỡ lỗi bằng SePay MCP.