# gameplay-mechanics

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 312 installs · ★ 56 repo stars
- Author: pluginagentmarketplace
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pluginagentmarketplace/custom-plugin-game-developer/tree/HEAD/skills/gameplay-mechanics/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gameplay-mechanics

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gameplay-mechanics/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gameplay-mechanics/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gameplay-mechanics/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gameplay-mechanics/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pluginagentmarketplace/custom-plugin-game-developer skills/gameplay-mechanics
```

2. **Manually: put the files in place**
- File: `.github/skills/gameplay-mechanics/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-game-developer --path skills/gameplay-mechanics
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gameplay-mechanics/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill gameplay-mechanics -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pluginagentmarketplace/custom-plugin-game-developer/tree/HEAD/skills/gameplay-mechanics/SKILL.md

## When to use it
- design combat states and transitions
- connect player input to game feedback
- compare resource income against spending
- sketch a character progression curve

## Example prompts
- 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.

## Similar
- [scenario-unity-gameplay](https://affpapa.org/en/nevibecode/skills/scenario-unity-gameplay.md) — skill · 591 installs
- [game-design](https://affpapa.org/en/nevibecode/skills/game-design.md) — skill · 247 installs
- [unreal-cpp-gameplay](https://affpapa.org/en/nevibecode/skills/unreal-cpp-gameplay.md) — skill · 10600 installs
- [scenario-roblox-gameplay](https://affpapa.org/en/nevibecode/skills/scenario-roblox-gameplay.md) — skill · 357 installs
- [combat-design](https://affpapa.org/en/nevibecode/skills/combat-design.md) — skill · 107 installs
- [game-dev-combat-skill-polish](https://affpapa.org/en/nevibecode/skills/game-dev-combat-skill-polish.md) — skill · ★ 7995 repo stars

From the same set: [pluginagentmarketplace/custom-plugin-game-developer](https://affpapa.org/en/nevibecode/by/pluginagentmarketplace/custom-plugin-game-developer.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
