cross-shop
A Claude Code skill that drives the cross.shop game web-shop platform (https://www.cross.shop) and its per-game subdomains rohan2.cross.shop, seal-m.cross.shop, rom.cross.shop — list game shops, fetch product catalogs, log in with a Game UUID, quote a purchase against a payment rail (CROSS or BNB), execute the on-chain payment leg via the per-chain payment escrow, and poll back-end delivery status. Targets CROSS Chain (chain id 612055) and BSC (56).
- Stack: EOA + viem (no ERC-4337, no paymaster, no Playwright)
- Backends: per-game shop API (subdomain or shared
api.cross.shop); endpoint slots populated via Phase-1 DevTools captures into references/games.json
- Subcommands:
games, products, login, quote, purchase, orders, status
- Distribution: standalone Claude skill and wrapped as a Claude Code plugin
v0.1-rc-skeleton — runnable scaffold, Phase-1 captures pending.
Only games.mjs runs end-to-end today (it just emits the registry). Every other subcommand short-circuits with {ok:false, error:"phase_1_not_captured", missing:"<slug>.<key>"} and exit code 3 until you follow skills/cross-shop/references/cross-shop.md to populate references/games.json for the games and rails you actually want to use.
purchase --pay CARD errors with unsupported_rail_v0_1 (hosted-checkout / 3DS deferred to v0.2).
Install — Recommended (via Marketplace)
/plugin marketplace add github.com/to-nexus/cross-skills-suite
/plugin install cross-shop@cross-skills-suite
Part of the CROSS Skills Suite — installs alongside cross-rewards, cross-dex-trade, cross-prediction, cross-crossd.
Install — Standalone
Option 1 — Plain skill (one user, fastest)
git clone <this-repo> /tmp/skill-cross-shop
bash /tmp/skill-cross-shop/install.sh # symlinks into ~/.claude/skills/
Or manually:
cp -r skills/cross-shop ~/.claude/skills/
cd ~/.claude/skills/cross-shop && npm install
Option 2 — Claude Code plugin (marketplace-installable)
{
"name": "cross-shop",
"source": { "source": "github", "repo": "to-nexus/skill-cross-shop" },
"category": "blockchain"
}
Activation
Activate when the user wants to:
- List the supported game shops (currently
rohan2, seal-m, rom) and their adapter completeness
- Browse the product catalog of one game shop
- Authenticate with a per-player Game UUID and (optionally) persist the session locally
- Quote a purchase by
(game, productId, payment rail)
- Execute a purchase end-to-end on
--pay CROSS or --pay BNB
- Read order history for the resolved session
- Poll a single order to terminal delivery state
Inside Claude Code, just describe the action in plain language. The skill activates on phrases like:
- "cross.shop 게임 목록"
- "rohan2 샵에서 살 수 있는 패키지 목록 보여줘"
- "seal-m 샵의 weekly costume 상품 BNB로 사줘"
- "ROM 게임 상품 CROSS로 결제해"
- "list available games on cross.shop"
- "buy seal-m package with CROSS"
- "show my cross.shop order history for rohan2"
Direct CLI:
cd ~/.claude/skills/cross-shop
node scripts/games.mjs # works today
node scripts/products.mjs rohan2 # needs Phase 1
PRIVATE_KEY=0x... node scripts/login.mjs rohan2 --uuid <UUID> --persist # needs Phase 1
node scripts/quote.mjs rohan2 <productId> --pay CROSS # needs Phase 1
PRIVATE_KEY=0x... node scripts/purchase.mjs rohan2 <productId> --pay CROSS --confirm
# needs Phase 1
node scripts/orders.mjs rohan2 # needs Phase 1
node scripts/status.mjs rohan2 <orderId> # needs Phase 1
All commands emit a single JSON object on stdout.
Prerequisites
- Node ≥ 20 (
node --version)
- Deps installed:
cd ~/.claude/skills/cross-shop && npm install
- For
login / purchase / orders: a wallet .env (see Configuration)
- For everything except
games: a populated references/games.json (see references/cross-shop.md)
Configuration
cp skills/cross-shop/.env.example skills/cross-shop/.env
chmod 600 skills/cross-shop/.env
