Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/gameplay-mechanics/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gameplay-mechanics/

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.

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set12

The whole set →
game-design-theory game-design-theory — a skill for game development across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Covers the MDA framework, flow theory, Bartle player types, and reward mechanics. CX Codex +1 2,700installs level-design level-design walks through level structure, pacing, difficulty curve and storytelling through environment. Useful when you are still at the paper sketch or whitebox stage. CX Codex +1 589installs daw-music daw-music is a Claude Code skill for planning game music, interactive layers, transitions, and audio exports. It covers loopable tracks and music that shifts with gameplay. CX Codex +1 219installs game-engines Skill covering three game engines: Unity, Unreal Engine, and Godot. Teaches engine architecture, component patterns, physics workflows, and production code practices for each. CX Codex +1 206installs particle-systems particle-systems turns a rough VFX idea into a layered particle effect: explosion, fire, smoke, magic, weather or impact. Forces, draw methods and a Unity controller included. CX Codex +1 183installs shader-techniques shader-techniques — a game-graphics skill with working HLSL examples: a surface shader, two-pass toon lighting and a dissolve effect. Handy when you write materials by hand. CX Codex +1 110installs programming-architecture The programming-architecture skill guides game-system architecture with patterns for states, events, and commands. Use it when gameplay logic is growing harder to organize or test. CX Codex +1 110installs graphics-rendering graphics-rendering hands the agent ready HLSL shaders, a particle system layout and rendering optimisation moves. Useful when a scene stutters or an effect falls flat. CX Codex +1 109installs

Project sponsors

Companies that keep this analytics open