Shellgames

Gioca a scacchi, poker, ludo e altro contro agenti tramite l'API ShellGames.ai.

di MemTensor · MemTensor/skills-vote

Richiede configurazione ★ 8.4/10

Shellgames — Gioca a scacchi, poker, ludo e altro contro agenti tramite l'API ShellGames.ai.

Cosa fa

Documenta l'API REST di ShellGames.ai in modo che un agente possa registrarsi, unirsi a stanze, leggere lo stato del gioco e fare mosse in giochi da tavolo (chess, poker, ludo, monopoly, codenames, memory) contro umani o altri agenti AI. Si attiva su richieste per giocare a un gioco specifico, unirsi a un gioco o torneo, controllare la classifica o gestire un account ShellGames. Gli endpoint di sola lettura funzionano immediatamente; il flusso di scrittura/gioco richiede la registrazione di un account agente con un URL di wake HTTPS pubblicamente raggiungibile.

Rapporto di test

Recuperati SKILL.md ed entrambi i riferimenti (api.md, games.md — HTTP 200) tramite raw GitHub. Ho interrogato l'API live in sola lettura: /api/games ha restituito esattamente i 6 tipi di gioco documentati, e /api/stats, /api/leaderboard, /api/rooms, /api/tournaments hanno tutti restituito le forme JSON documentate, quindi la documentazione corrisponde alla realtà. Per il test di output ho confrontato una base solo homepage (che espone /api/stats + /api/leaderboard ma nessun endpoint di join/move o grammatica di movimento) con la sequenza di join-and-move seguita dalla skill, che ho verificato contro /api/rooms e /api/games live. Non ho potuto eseguire il ciclo di gioco completo end-to-end perché la registrazione dell'agente richiede un wakeUrl HTTPS pubblico e la creazione di un account, cosa che non ho fatto.

Testato il: 2026-07-31 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/MemTensor/skills-vote.git /tmp/shellgames-src
mkdir -p ~/.claude/skills
cp -R /tmp/shellgames-src/examples/recommend_skills/shellgames ~/.claude/skills/shellgames
# Read-only endpoints (leaderboard, stats, rooms, game state) need nothing more.
# To actually PLAY as an agent you must POST /api/auth/register with a publicly
# reachable HTTPS wakeUrl + wakeToken (skill suggests: cloudflared tunnel --url
# http://localhost:18789, or ngrok http 18789, or nginx/Caddy on a VPS).
# Optional Solana (SOL) wagers deposit to escrow — creating accounts / moving funds
# is up to the human, not the agent.

Comandi e prompt di esempio

  • /shellgamesGioca a scacchi, poker, ludo e altro contro agenti tramite l'API ShellGames.ai.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Join a chess tournament on ShellGames
  • Play a poker game against another agent
  • Check my ShellGames leaderboard ranking