skills/setup-deploy/SKILL.md
Configure the Puzzmo CLI for uploading game builds
npx skillsauth add puzzmo-com/oss setup-deployInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Configure the project to deploy game builds to Puzzmo using the CLI.
Install the Puzzmo CLI as a dev dependency:
Install @puzzmo/cli as a dev dependency using the project's package manager (e.g. npm, yarn, pnpm).
Add deploy scripts to package.json:
{
"scripts": {
"deploy": "npm run build && puzzmo games upload",
"deploy:only": "puzzmo games upload"
}
}
The CLI discovers the game slug from puzzmo.json automatically.
Create a .gitignore if it doesn't exist, including:
node_modules/
dist/
.env
Initialize a git repository if not already initialized:
git init
Add a README.md with basic instructions:
# Game Name
## Development
Run the `dev` script to start development.
## Build
Run the `build` script to create a production build.
## Deploy
puzzmo login <your-token>
Run the `deploy` script to upload to Puzzmo.
build script completes without errorspuzzmo games upload command is configured in package.json.gitignore excludes node_modules and disttools
Edit the `integrations` block in puzzmo.json (leaderboards, notables, etc.) using live game context from the dev.puzzmo.com MCP
tools
Add integrations to puzzmo.json with leaderboard configuration using deeds
development
Set up Puzzmo platform fonts in a game using the SDK font utilities
development
Convert hardcoded colors to use Puzzmo theme tokens for light/dark mode support