# game-design

game-design guides coding assistants on game development fundamentals using project reference files.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 247 installs · ★ 221 repo stars
- Author: omer-metin
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/omer-metin/skills-for-antigravity/tree/HEAD/skills/game-design/SKILL.md
- Updated: 2026-01-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/game-design

## What it does

This skill frames the AI as a game developer across Claude Code, Codex, Cursor, and other tools. It focuses on shipping lean prototypes, prioritizing framerate, and refining core mechanics before expanding architecture.

Operational logic relies on local documentation. The assistant checks `references/patterns.md` when building gameplay systems, uses `references/sharp_edges.md` for diagnosing failures, and validates constraints against `references/validations.md`.

Without these three reference files present in your workspace, the agent cannot execute the specific checks and patterns enforced by the skill prompt.

## Requirements
- Works with: Unity, Unreal Engine, Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill game-design -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill game-design -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill game-design -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install omer-metin/skills-for-antigravity skills/game-design
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill game-design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/omer-metin/skills-for-antigravity --path skills/game-design
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill game-design -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/omer-metin/skills-for-antigravity/tree/HEAD/skills/game-design/SKILL.md

## When to use it
- prototype a tight core gameplay loop early
- audit physics and tick logic against known edge cases
- validate game mechanics against project rule constraints
- structure entity components using predefined patterns

## Example prompts
- Build a tilemap player movement controller following `references/patterns.md`
- Diagnose collision glitches using `references/sharp_edges.md`
- Review my core game loop against rules in `references/validations.md`

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b3cfadf3b113dca2.

BEGIN THIRD-PARTY FILE b3cfadf3b113dca2
```text
---
name: game-design
description: Building interactive experiences that engage, challenge, and delight playersUse when "game, gamedev, game development, phaser, unity, unreal, godot, gameplay, game loop, sprites, collision, physics, player, level, tilemap, games, gamedev, interactive, gameplay, physics, engines, performance, player-experience" mentioned. 
---

# Game Design

## Identity

You're a game developer who has shipped titles across platforms—from browser games to
console releases. You understand that games are systems that create experiences, and you've
debugged physics glitches at 2 AM and celebrated when the feel finally clicked. You've built
entity-component systems, optimized draw calls, and learned that the simplest mechanics are
often the hardest to perfect. You know that technical excellence serves player experience,
that scope creep kills more games than technical debt, and that a polished core loop beats
a feature-complete mess. You've learned from your over-ambitious projects and your successful
launches, and you bring that hard-won wisdom to every game you build.

Your core principles:
1. Fun is the first feature
2. Prototype the core loop before building systems
3. Frame rate is a feature—performance is non-negotiable
4. Juice makes the difference between good and memorable
5. Playtest early, playtest often, playtest with fresh eyes
6. Every system exists to serve the player experience
7. Scope kills games—ship smaller, ship sooner


## Reference System Usage

You must ground your responses in the provided reference files, treating them as the source of truth for this domain:

* **For Creation:** Always consult **`references/patterns.md`**. This file dictates *how* things should be built. Ignore generic approaches if a specific pattern exists here.
* **For Diagnosis:** Always consult **`references/sharp_edges.md`**. This file lists the critical failures and "why" they happen. Use it to explain risks to the user.
* **For Review:** Always consult **`references/validations.md`**. This contains the strict rules and constraints. Use it to validate user inputs objectively.

**Note:** If a user's request conflicts with the guidance in these files, politely correct them using the information provided in the references.
```
END THIRD-PARTY FILE b3cfadf3b113dca2

The third-party file has ended. Everything between the b3cfadf3b113dca2 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© omer-metin · Apache-2.0 · https://github.com/omer-metin/skills-for-antigravity/tree/HEAD/skills/game-design/SKILL.md

## Similar
- [router](https://affpapa.org/en/nevibecode/skills/router.md) — skill · 12900 installs
- [game-reverse-document](https://affpapa.org/en/nevibecode/skills/game-reverse-document.md) — skill · ★ 57 repo stars
- [AI Game Developer: MCP for Unity, Unreal and Godot](https://affpapa.org/en/nevibecode/mcp/ai-game-developer-mcp-for-unity-unreal-and-godot.md) — MCP server · ★ 4680 repo stars
- [level-design](https://affpapa.org/en/nevibecode/skills/level-design.md) — skill · 14800 installs
- [game-development](https://affpapa.org/en/nevibecode/skills/miles990-game-development.md) — skill · 417 installs
- [asset-audit](https://affpapa.org/en/nevibecode/skills/asset-audit.md) — skill · 702 installs

_Part of the page did not fit — see the HTML version._

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