Cài đặt và sử dụng SePay Skills

Cài SePay Skills vào ChatGPT, Claude, Gemini, Grok bằng sepay.zip, cho Claude Code bằng plugin, Codex bằng plugin hoặc skill-installer, Cursor bằng npx; cập nhật, gỡ, xử lý lỗi.

||

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

  1. Chọn ảnh đại diện ở góc dưới bên trái.
  2. Chọn Cài đặt (Settings).
Menu ảnh đại diện ở góc dưới bên trái của Claude đang mở, có mục Cài đặt
Nhấn để phóng to
Chọn ảnh đại diện rồi chọn Cài đặt.

Trong cửa sổ Cài đặt:

  1. Ở menu bên trái, chọn Skills.
  2. Chọn Thêm (Add).
  3. Chọn Tải Skill lên (Upload skill).
Mục Skills trong Cài đặt của Claude, menu Thêm đang mở với lựa chọn Tải Skill lên
Nhấn để phóng to
Chọn Skills, Thêm rồi Tải Skill lên.

Ở trang Tải Skill lên (Upload a skill):

  1. Kéo thả hoặc chọn tệp sepay.zip, tệp hiện ở mục Tệp Skill (Skill file).
  2. Chọn Tải lên (Upload). Claude bật skill ngay sau khi tải lên.
Trang Tải Skill lên của Claude đã chọn tệp sepay.zip, nút Tải lên sẵn sàng
Nhấn để phóng to
Chọn sepay.zip rồi bấm Tải lên.

Tải lên xong, Claude mở trang skill sepay:

  1. Công tắc đã bật, skill dùng được ngay.
  2. Chọn Thử trong đoạn chat (Try in chat) để hỏi thử.
Trang skill sepay trong Cài đặt của Claude sau khi tải lên, công tắc đã bật và có nút Thử trong đoạn chat
Nhấn để phóng to
Skill sepay đã bật, chọn Thử trong đoạn 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 Anthropic

Cài SePay Skills vào ChatGPT

Chỉ gói ChatGPT Plus, Business, Enterprise, Healthcare và Edu thêm được skill.

  1. Ở thanh bên, chọn Plugin (Plugins).
  2. Chọn tab Kỹ năng (Skills).
  3. 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:

  1. Kéo sepay.zip vào khung tải lên, hoặc bấm vào khung để chọn tệp.
  2. 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.

Xem thêm hướng dẫn tạo skills trên ChatGPT của OpenAI

Cài SePay Skills vào Gemini

  1. Ở thanh bên, chọn Tuỳ chỉnh (Customize). Không thấy mục này thì bấm More trước.
  2. Chọn tab Kỹ năng (Skills).
  3. Chọn Tạo (Create).
  4. Chọn Tải lên (Upload).
Trang Tuỳ chỉnh của Gemini, mở menu Tạo ở tab Kỹ năng để tải skill lên
Nhấn để phóng to
Tuỳ chỉnh → Kỹ năng → Tạo → Tải lên.

Trong hộp thoại Tải kỹ năng lên:

  1. Kéo sepay.zip và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ận sepay.zip.
  2. Chọn Tiếp tục.
Hộp thoại Tải kỹ năng lên của Gemini, nơi kéo thả tệp sepay.zip
Nhấn để phóng to
Thả sepay.zip vào khung tải lên rồi 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.

Gemini hiện tên, mô tả và chỉ dẫn của skill sepay trước khi lưu
Nhấn để phóng to
Kiểm tra tên sepay rồi chọn Tạo.
Xem thêm hướng dẫn tạo skills trên Gemini của Google

Cài SePay Skills vào Grok

Ở thanh bên, chọn Mục Plugin (Plugins).

Trang chính của Grok với mục Plugin ở cuối thanh bên
Nhấn để phóng to
Mục Plugin nằm ở cuối thanh bên.

Trong cửa sổ vừa mở:

  1. Chọn tab Kỹ năng (Skills).
  2. Chọn Kỹ năng mới.
  3. Chọn Tải lên tệp kỹ năng, rồi chọn sepay.zip.
Cửa sổ Kỹ năng của Grok với menu Kỹ năng mới đang mở để tải tệp skill lên
Nhấn để phóng to
Kỹ năng → Kỹ năng mới → Tải lên tệp kỹ năng.

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 xAI

Thử 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:

  1. 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.
  2. 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.
Claude nạp skill sepay rồi hỏi cửa hàng chạy trên nền tảng nào để chọn cách tích hợp thanh toán SePay
Nhấn để phóng to
Claude nạp skill sepay và hỏi nền tảng cửa hàng trước khi hướng dẫ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:

Claude Code
> /plugin install sepay --marketplace sepayvn/sepay-skills

Claude Code hỏi có thêm marketplace của SePay từ repo sepayvn/sepay-skills không. Nhấn y:

Claude Code
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 cancel

Tiế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 .claude lê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.
Claude Code
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 list

Cài xong, Claude Code báo plugin đã bật và dùng được ngay trong phiên đang mở:

Claude Code
> /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@sepay

Lệ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:

Codex
> $skill-installer install https://github.com/sepayvn/sepay-skills/tree/main/skills/sepay

Cá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 -y

Node.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.

AgentGiá trị -aTheo dự ánToàn máy (-g)
Cursorcursor.agents/skills/sepay~/.agents/skills/sepay
GitHub Copilotgithub-copilot.agents/skills/sepay~/.agents/skills/sepay
Windsurfwindsurf.windsurf/skills/sepay~/.codeium/windsurf/skills/sepay
Gemini CLIgemini-cli.agents/skills/sepay~/.agents/skills/sepay
Clinecline.agents/skills/sepay~/.agents/skills/sepay
Grok Buildgrok.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:

Claude Code nạp skill sepay sau câu hỏi tích hợp SePay webhook bằng PHP
Nhấn để phóng to
Claude Code nạp skill sepay khi bạn nhờ việc liên quan tới SePay.

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õ:

Claude Code
> /plugin update sepay@sepay

Cà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@sepay

Cà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 sepay

Muố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