xsolla-ai-kit
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 10 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Xsolla agent skills for AI coding tools — Claude Code, Copilot, Codex CLI, Windsurf and more
Xsolla AI Toolkit
Agent skills for Xsolla — works with Claude Code, GitHub Copilot, Codex CLI, Windsurf, Roo Code, Augment, and more.
Install the kit in your AI coding tool and your agent can integrate Xsolla's APIs directly into your game, build a fully functional headless web shop you own and host with full control of the frontend, or, in preview, assemble a Shop Builder site from a plain-language description of your game. It works with the AI coding tools you already use, with no engine lock-in and no proprietary assistant. Instead of generating code that looks right but breaks in production, your agent follows validated, production-ready logic encoding the correct integration paths, so the first AI-assisted attempt is the right one, with validation built in. From setting up a project and configuring a catalog to integrating Pay Station and implementing webhooks, the kit takes you from zero to a working integration.
On the Shop Builder path, in preview, the agent turns your game description into a validated shop brief and builds an unpublished Shop Builder site from it through the Xsolla CLI, in your own Publisher Account project. You review the site and publish it yourself in Publisher Account.
To use it today, install the Xsolla CLI 1.9.4 or later: brew install xsolla/xsolla-cli/xsolla. A new store opens in the Shop Builder Editor and preview only with a CLI that has shopbuilder create-block, and no released CLI has it yet (1.9.4 is the latest); the agent checks this first and tells you.
What's inside
| Directory | Purpose |
|---|---|
skills/ |
SKILL.md files — one per Xsolla domain |
AGENTS.md |
Universal context loaded automatically by most agents |
.github/copilot-instructions.md |
GitHub Copilot-specific context |
.cursor/skills/ |
Cursor-native skills (synced from skills/) |
.cursor/rules/ |
Short always-on Cursor pointer rule |
Quick start
Install the kit as a plugin in your preferred coding agent, or copy it into your project for any tool that follows the AGENTS.md convention:
Claude Code
claude plugin marketplace add xsolla/xsolla-ai-kit && claude plugin install xsolla-ai-kit@xsolla-ai-kit
Or in a session:
/plugin marketplace add xsolla/xsolla-ai-kit
/plugin install xsolla-ai-kit@xsolla-ai-kit
Cursor
Add this repo as a workspace folder (or open it as the project), then use natural language — Cursor loads skills from .cursor/skills/.
# Example
Integrate Xsolla Headless Checkout and let me pay with a credit card in sandbox
For an end-to-end shop, start with shop-setup. A short always-on rule in .cursor/rules/xsolla-ai-kit.mdc points the agent at those skills.
Codex
codex plugin marketplace add xsolla/xsolla-ai-kit
Gemini CLI
gemini extensions install https://github.com/xsolla/xsolla-ai-kit
Other tools (Windsurf, Roo Code, Augment, Amp, Copilot, …)
For tools with no official plugin system, use the kit by copying AGENTS.md and the skills/ directory into your project root. Any tool that follows the AGENTS.md convention will pick the skills up automatically the next time you open the project:
git clone https://github.com/xsolla/xsolla-ai-kit
cp -r xsolla-ai-kit/AGENTS.md xsolla-ai-kit/skills your-game-project/
Then set environment variables or run the merchant-setup skill:
XSOLLA_MERCHANT_ID=<your merchant ID>
XSOLLA_PROJECT_ID=<your project ID>
XSOLLA_PROJECT_API_KEY=<your API key>
Skill inventory
| Skill | Domain | Owner | Status |
|---|---|---|---|
shop-setup |
Coded shop — the user writes and deploys | @y.klochikhin | Done |
nocode-shop-setup |
Shop Builder entry — store or game home | @a.pyanzin | Draft |
description-to-shop |
Description → Shop Builder shop brief | @k.shah | Draft |
shop-builder-assembly |
Shop Builder site assembly | @k.shah | Draft |
game-web-portal |
Game Web Portal — PC game home + shop | @a.pyanzin | Draft |
shopbuilder-translate |
Shop Builder page copy | @s.hossain | Draft |
xla-pages |
XLA Pages on x.la — game and payment provider pages | @a.pyanzin | Draft |
merchant-setup |
Merchant and Project setup | @y.klochikhin | Done |
catalog-design |
Items, pricing, virtual currency, bundles | @p.sanachev | Planned |
login-setup |
Login / NewID / auth | @mohammed_abujalala | Planned |
login-styling |
Login UI theming / branding | @a.springut | Draft |
headless-checkout-integration |
Payments via Headless Checkout | @y.klochikhin | Done |
webhooks-impl |
Webhook handler generation | @e.chernykh | Done |
production |
Sandbox → live / go-live | @y.klochikhin | Done |
quest-setup |
Quest Platform quests, events, rewards, Web Shop and Shop Builder Quests operations | @r.aliyev | Draft |
Invoking a skill
Skills load automatically once the plugin is installed — the agent picks the
right one from your request (e.g. "build me a shop" → shop-setup). To force a
specific skill:
| Agent | Explicit invocation |
|---|---|
| Claude Code | /shop-setup (slash command; /xsolla-ai-kit:shop-setup if names clash) |
| Cursor | Describe the task (skills under .cursor/skills/) — or @ a skill by name |
| Codex CLI | No per-skill command — describe the task; Codex routes via AGENTS.md |
| Others | Natural language; skills load from SKILL.md / generated rules |
shop-setup is the entry for a shop the user codes and deploys. It chainscatalog-design, login-setup, headless-checkout-integration, webhooks-impl,
and production. nocode-shop-setup is the entry for Shop Builder: a store goes todescription-to-shop and shop-builder-assembly, and a PC game home goes togame-web-portal. shopbuilder-translate translates the page copy of a Shop Builder
site. xla-pages builds the XLA Pages on x.la from their own manifest. quest-setup creates
and manages Quest Platform quests, events, rewards, Web Shop quest modules, and approved
Shop Builder Quests block operations.
Contributing
See CONTRIBUTING-skills.md for the full guide on writing a skill.
License
© 2026 Xsolla Inc. All rights reserved.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found