verify-puzzle-game

Runs and verifies browser games through builds, scripted bot play, and completion gates.

1|Updated Aug 31, 2026
One-click install
npx skills add https://github.com/gagandeepgill/puzzle-game --skill verify-puzzle-game-gagandeepgill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verify-puzzle-game
Source: https://github.com/gagandeepgill/puzzle-game/tree/main/.claude/skills/verify-puzzle-game
Command: npx skills add https://github.com/gagandeepgill/puzzle-game --skill verify-puzzle-game-gagandeepgill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Confirming that a change to a browser game actually works requires more than reading the code: builds go stale, service workers serve old bundles, and balance claims need real playthroughs. This Skill encodes the exact procedure for building, serving, driving, and bot-playing this repo's games so verification produces trustworthy results. ## Core Features & Use Cases - Build and serve correctly: Distinguishes the React/TypeScript Payload build from single-file games, rebuilds dist/ before testing, and clears stale service workers that hide new code. - Scripted bot playthroughs: Drives full game runs through accessible names in the browser pane, using lazy and competent bots to validate quota curves and difficulty tuning with real numbers. - Completion gates: Enforces a checklist before calling work done, including clean console errors, full runs to the end screen, seed determinism checks, npm test, npm run typecheck, and a clean git status. - Use Case: After changing Payload's quota math, use this Skill to rebuild, clear the service worker, run both bots to completion, and report actual scores proving Easy is winnable and Hard is appropriately tight. ## Quick Start Ask the assistant to verify that your recent change to the game actually works by building, serving, and bot-playing a full run.

Frequently Asked Questions about verify-puzzle-game

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run and test a browser game after changing its code?▼

Rebuild first with npm run build, then serve dist/ with node tools/serve.js at localhost:8000, since dist/ is stale until rebuilt. Clear the service worker before reloading, because it caches the app shell and will otherwise show the old code.

How do I bot-play a game run to check difficulty balance?▼

Drive the game through accessible names rather than class names, scripting draft picks and column drops in the browser console. Use two bots: a lazy bot that must lose, and a competent bot that must win Easy and get close on Hard, reporting real numbers.

Why does my browser test show old code after rebuilding?▼

The service worker caches the app shell, so a reload can still serve the previous build. Unregister all service worker registrations and delete every cache entry, then reload the page to see the new code.

Can I test the single-file game without a dev server?▼

Ledger Lane is one self-contained HTML file, so file:// works directly from source. Payload needs the server because it loads hashed bundles and registers a service worker, so use tools/serve.js for it.

Why do timer-based measurements hang in the browser pane?▼

The browser pane throttles background tabs: requestAnimationFrame never fires when hidden and setTimeout is clamped to about a second. Front the tab first, or measure the pure function in Node instead.