xsolla-ai-kit

mcp
Security Audit
Pass
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.

SUMMARY

Xsolla agent skills for AI coding tools — Claude Code, Copilot, Codex CLI, Windsurf and more

README.md

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 chains
catalog-design, login-setup, headless-checkout-integration, webhooks-impl,
and production. nocode-shop-setup is the entry for Shop Builder: a store goes to
description-to-shop and shop-builder-assembly, and a PC game home goes to
game-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)

No results found