add-feature

Q: How do I install add-feature?

Run npx skills add https://github.com/playableintelligence/game-creator --skill add-feature in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/add-feature/ (personal) or .claude/skills/add-feature/ (project).

by playableintelligenceMedia & Creative

Add a new gameplay feature to an existing browser game following its architecture patterns. Use when the user says "add a feature", "add double-jump", "add a power-up", "add a leaderboard", or describes a specific game mechanic to implement. Do NOT use for visual-only changes (use design-game) or replacing shapes with sprites (use add-assets).

Installs: 980
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/playableintelligence/game-creator --skill add-feature

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads add-feature automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Performance Notes

Take your time to do this thoroughly
Quality is more important than speed
Do not skip validation steps

Add Feature

Add a new feature to your game. Just describe what you want in plain English — for example, "add a double-jump power-up" or "add a high score leaderboard" — and the feature will be built following your game's existing patterns.

Instructions

The user wants to add: $ARGUMENTS

Step 1: Understand the codebase

Read package.json to identify the engine (Three.js or Phaser)
Read src/core/Constants.js for existing configuration
Read src/core/EventBus.js for existing events
Read src/core/GameState.js for existing state
Read src/core/Game.js (or GameConfig.js) for existing system wiring
Read existing scene and gameplay files to understand what's already built

Step 2: Plan the feature

Before writing code, explain the plan in plain English:

What it does: Describe the feature from the player's perspective
How it works: List the new files, events, and settings that will be created
What it touches: List existing files that need small changes to wire in the feature

Then determine what's needed technically:

New module file(s) and where they go in the directory structure
New events to add to the Events enum
New constants to add to Constants.js
New state to add to GameState.js
How to wire it into the Game orchestrator

Step 3: Implement

Follow these rules strictly:

Create the new module in the correct src/ subdirectory
Add ALL new events to EventBus.js Events enum
Add ALL configuration values to Constants.js (zero hardcoded values)
Add any new state domains to GameState.js
Wire the new system into Game.js (import, instantiate, update in loop)
Use EventBus for ALL communication with other systems
Follow the existing code style and patterns in the project

Step 4: Verify

Run npm run build to confirm no errors
Confirm the feature integrates without breaking existing systems
Check that no circular dependencies were introduced
Ensure event listeners are properly cleaned up if applicable
Summarize what was added in plain English

Troubleshooting

Game breaks after adding feature

Cause: New code conflicts with existing EventBus events or GameState fields. Fix: Check for event name collisions in EventBus.js. Ensure new state fields have defaults in GameState.reset().

Feature works but breaks existing gameplay

Cause: Modified shared constants or collision groups. Fix: Add new constants rather than changing existing ones. Test original gameplay after changes.

Output

Tell the user:

What the feature does (from the player's perspective)
What files were created or changed
How to test it — "Run npm run dev and try [specific action]"

Example Usage

Adding a power-up

/add-feature add a speed boost power-up that spawns randomly

Result: Creates src/entities/PowerUp.js, adds POWER_UP events to EventBus, adds spawn timing and duration to Constants.js, wires into Game.js. Player collects power-up → speed doubles for 8 seconds.

Adding a scoring mechanic

/add-feature add combo multiplier that increases when you score quickly

Result: Adds comboMultiplier and comboTimer to GameState, creates combo logic in scoring system, adds COMBO_CHANGED event for UI updates.

Tips

You can run this command as many times as you want to keep adding features. Each one builds on the last.

When you're happy with the gameplay, run /game-creator:design-game to polish the visuals, /game-creator:add-audio for music and sound effects, or /game-creator:review-game for a full quality check.

FAQ

What does the add-feature skill do?

How do I install add-feature?

Run npx skills add https://github.com/playableintelligence/game-creator --skill add-feature in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/add-feature/ (personal) or .claude/skills/add-feature/ (project).

Which AI agents can use add-feature?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is add-feature safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains add-feature?

It is published by playableintelligence in playableintelligence/game-creator. It has 980 recorded installs.