game-preview

Detect the project root and start a local HTTP server for game previews.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/donghyun-bagelcode/2026-ai-jam --skill game-preview-donghyun-bagelcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: game-preview
Source: https://github.com/donghyun-bagelcode/2026-ai-jam/tree/main/.gemini/skills/game-preview
Command: npx skills add https://github.com/donghyun-bagelcode/2026-ai-jam --skill game-preview-donghyun-bagelcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates starting a local server to preview a game project directly in a browser, enabling quick verification even for non-developers.

Core Features & Use Cases

  • Automatic project discovery: finds the game root using common indicators (playforge.config.json, game/index.html, index.html, dist/index.html).
  • Flexible server selection: uses npx serve when available, with Python http.server as a fallback, and guidance to install Live Server if neither is present.
  • Mobile testing & sharing: provides localhost and local IP addresses for testing on mobile devices, and optional viewport tools.

Quick Start

Run the game preview by saying "run game" or "preview" to start the local server and open the game in your browser.

Frequently Asked Questions about game-preview

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

FAQPage Schema
How do I preview my web game in a browser using a local server?

To preview your web game, you need a local HTTP server. This skill automatically detects your project root using files like index.html and starts a server using Node.js or Python so you can open the game in your browser.

Can I test my web game on a mobile device using a local server?

Yes, you can test your web game on mobile. The local server provides both localhost and local IP addresses, allowing you to connect and verify your game directly from a mobile browser on the same network.

Do I need Node.js to run a local game preview, or can I use Python?

You do not strictly need Node.js; you can use Python. The tool first tries npx serve if Node.js is available, but falls back to Python http.server, and guides you to install Live Server if neither is present.

What is the best way to automatically find and serve a game project root?

The best way to find and serve a game project root is using automatic discovery. The tool searches for common indicators like playforge.config.json, game/index.html, or dist/index.html to identify the root and serve it instantly.

What should I do if neither Node.js nor Python is available to start the HTTP server?

If neither Node.js nor Python is available to start the HTTP server, you will receive guidance to install Live Server. This ensures you have a fallback method to launch your web game preview locally.