game-playtest — Codex skill: what it does, how to install
Guides agents through browser game playtests and frontend QA. It focuses on boot checks, controls, HUD overlay balance, and visual regression capture.
npx skills add openai/plugins --skill game-playtest -a codexWhat game-playtest does
This skill guides agents through testing browser games from a player perspective. The workflow covers initial boot, core verbs, and independent inspection of UI versus render layers. For 2D games, checks target sprite alignment and HUD overlap. For 3D titles, it tracks WebGL context loss, pointer lock, camera resets, and GLB streaming stalls.
Tooling relies on Playwright or existing project automation. Because standard DOM assertions miss canvas errors, screenshot captures are mandatory. For 3D rendering defects and sudden frame drops, the skill instructs agents to use SpectorJS and browser profiling tools instead of guessing from source code.
Install this if your repo runs HTML5 or WebGL games and needs structured visual verification. Projects without a runnable browser build will not gain much from it.
What it helps with
- run smoke tests on game boot and actionable screens
- catch canvas visual regressions with automated screenshots
- review HUD overlap and playfield visibility
- debug 3D performance drops using SpectorJS
Example prompts for the agent
- Run a smoke test on the browser game and confirm the first actionable screen.
- Check if the HUD or secondary panels overlap the playfield.
- Capture screenshots across scene transitions and test WebGL context loss.
How to install game-playtest
1Skills CLI (Vercel)
npx skills add openai/plugins --skill game-playtest -a codex2Manually: put the files in place
.agents/skills/game-playtest/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill game-playtest -a claude-code2Manually: put the files in place
~/.claude/skills/game-playtest/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/game-playtest/
Manually: put the files in place
.cursor/skills/game-playtest/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins game-playtest2Manually: put the files in place
.github/skills/game-playtest/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/game-studio/skills/game-playtestManually: put the files in place
.devin/skills/game-playtest/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Similar
Questions about game-playtest
How do I install game-playtest in Codex?
Run npx skills add openai/plugins --skill game-playtest -a codex in your terminal. The skill file is placed in .agents/skills/game-playtest/SKILL.md.
What does game-playtest do?
It standardizes frontend playtesting for web games, covering input responsiveness, UI legibility, viewport changes, and visual state reporting.
Why does the skill require screenshots for canvas games?
DOM-based assertions cannot detect visual glitches inside canvas or WebGL elements. Screenshots confirm actual rendering output and HUD layout balance.
Source text
SKILL.md · MIT
--- name: game-playtest description: Run browser-game playtests and frontend QA. Use when the user asks for smoke tests, screenshot-based verification, browser automation, HUD or overlay review, or structured issue-finding in a browser game. --- # Game Playtest ## Overview Use this skill to test browser games the way players experience them: through boot, input, scene transitions, HUD readability, and visual state changes. Prefer browser automation and screenshot review when the project supports it. ## Preferred Workflow 1. Boot the game and confirm the first actionable screen. 2. Exercise the main verbs. 3. Capture screenshots from representative states. 4. Check the UI layer independently from the render layer. 5. Report findings in severity order with reproduction steps. ## Tooling Guidance - Prefer Playwright or equivalent browser automation already available in the repo. - When the game is canvas or WebGL heavy, screenshots are mandatory because DOM assertions alone miss visual regressions. - Use screenshots to judge playfield obstruction and HUD weight, not just correctness of text or layout. - When deterministic automation is not practical, do a structured manual pass and capture evidence. - For 3D rendering bugs or unexplained frame cost, use SpectorJS and browser performance tooling rather than guessing from code alone. ## Common Checks ### 2D checks - sprite alignment and baseline consistency - hit or hurt animation readability - HUD overlap with the playfield - command menu state changes - tile or platform readability - input-state feedback and turn-state clarity ### 3D checks - first-load playability versus dashboard-like chrome - persistent overlay weight versus playfield visibility - camera control and camera reset behavior - pointer-lock or drag-look transitions when menus and overlays open - depth readability and silhouette clarity - secondary panels collapsed or dismissible during normal play - resize behavior - WebGL context loss or renderer fallback behavior - material or lighting regressions - GLB or texture streaming stalls - collision proxy or physics mismatch - performance cliffs tied to post-processing or asset load ## Responsive and Browser Checks - desktop and mobile viewport sanity - safe-area and notch issues where relevant - reduced-motion behavior for UI transitions - keyboard, pointer, and pause-state handling - React state and scene state synchronization when the project uses React Three Fiber ## Reporting Standard Lead with findings. Keep each finding concrete: - what the user sees - how to reproduce it - why it matters - what likely subsystem owns it ## References - Shared architecture: `../web-game-foundations/SKILL.md` - Frontend review cues: `../game-ui-frontend/SKILL.md` - 3D debugging notes: `../../references/webgl-debugging-and-performance.md` - Full checklist: `../../references/playtest-checklist.md`
© OpenAI · MIT · openai/plugins