gameplay-mechanics — Claude Code skill: mechanics and setup
gameplay-mechanics is a Claude Code skill that plans combat, resource economies, and progression, then connects player actions to in-game responses for building and tuning gameplay systems.
LicenseRef-Proprietary 312 installs ★ 56 updated 2026-01-05
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a claude-codeWhat gameplay-mechanics does
The skill lays out how a player input can lead to a state change and then to feedback such as sound, animation, visual effects, or vibration. It groups feedback by when the player receives it, from an immediate response to later progress notifications. That structure helps map out what the game communicates at each stage.
A C# combat example for Unity uses states for attacking, blocking, recovery, and stagger. It checks nearby targets and applies damage through IDamageable. The material also covers comparing resource income with spending and shaping a progression curve. You can set a mechanic category and complexity as parameters. The combat sample relies on Unity’s MonoBehaviour and Physics, so it needs adaptation for another engine.
What it helps with
- design combat states and transitions
- connect player input to game feedback
- compare resource income against spending
- sketch a character progression curve
Example prompts for the agent
- Design a Unity combat system with attacks, blocking, and recovery states.
- Map the feedback a player should receive after a hit, from the first response to later effects.
- Review my resource economy by comparing income and spending, then suggest balance changes.
How to install gameplay-mechanics
1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a claude-code2Manually: put the files in place
~/.claude/skills/gameplay-mechanics/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gameplay-mechanics/
1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a codex2Manually: put the files in place
.agents/skills/gameplay-mechanics/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a cursor2Manually: put the files in place
.cursor/skills/gameplay-mechanics/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pluginagentmarketplace/custom-plugin-game-developer skills/gameplay-mechanics2Manually: put the files in place
.github/skills/gameplay-mechanics/SKILL.md1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a gemini-cli2Platform CLI
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-game-developer --path skills/gameplay-mechanicsManually: put the files in place
.devin/skills/gameplay-mechanics/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gameplay-mechanics
How do I install gameplay-mechanics in Claude Code?
Run npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a claude-code. The skill file is placed at ~/.claude/skills/gameplay-mechanics/SKILL.md.
What does gameplay-mechanics do?
It guides the design of gameplay systems, their interactions, player feedback, and balance. Examples cover combat, resource economies, and progression.
Can I use the combat example outside Unity?
The sample is written in C# and uses Unity’s MonoBehaviour and Physics. Adapt it for a different engine.