xsolla-ai-kit
Xsolla agent skills toolkit — guided, end-to-end workflows for merchant setup, catalog design, Login/NewID, Pay Station, webhooks, storefron
Open source Open in the app JSON README (API)
About
Xsolla agent skills toolkit — guided, end-to-end workflows for merchant setup, catalog design, Login/NewID, Pay Station, webhooks, storefront build, and shop branding, calling Xsolla REST APIs directly.
Details
- Kind
- Plugins
- Topic
- E-commerce & business
- Publisher
- xsolla
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 3
- Forks
- 2
- Open pull requests
- 4
- Last push
- 2026-08-19T13:55:53Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
xsolla/xsolla-ai-kit/xsolla-ai-kit
README
# 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, or build a fully functional headless web shop you own and host with full control of the frontend. 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. ## 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 | | `docs/` | Architecture, distribution, and skill-gap guides | ## 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](https://agents.md) convention: ### Claude Code ```bash claude plugin marketplace add xsolla/xsolla-ai-kit && claude plugin install xsolla-ai-kit@xsolla-ai-kit ``` Or in a session: ```text /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/`. ```text # 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 ```bash codex plugin marketplace add xsolla/xsolla-ai-kit ``` ### Gemini CLI ```bash 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](https://agents.md) convention will pick the skills up automatically the next time you open the project: ```bash 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: ```bash 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` | Orchestrator — full zero-to-shop flow | @y.klochikhin | Done | | `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 | | `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 | ## 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 point — it scopes the build and chains the domain skills (`catalog-design`, `login-setup`, `headless-checkout-integration`, `webhooks-impl`, `production`). ## Contributing See [CONTRIBUTING-skills.md](CONTRIBUTING-skills.md) for the full guide on writing a skill. ## License © 2026 Xsolla Inc. All rights reserved.