# godot-genre-action-rpg

A skill that steers your coding agent through Action RPG work in Godot: combat, stats, loot and progression.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 354 installs · ★ 893
- Author: thedivergentai
- License: LGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-genre-action-rpg/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/godot-genre-action-rpg

## What it does

The skill covers the moving parts of an Action RPG in Godot: hitbox and hurtbox combat, damage driven by stats, leveling with skill trees, procedural item generation with affixes and rarity tiers, gear slots, and abilities with cooldowns and mana cost. It ships GDScript files such as `hitbox_component.gd`, `aoe_physics_query.gd`, `loot_generator.gd`, `combat_damage_calculator.gd` and `threaded_inventory_loader.gd`. Several are marked mandatory, so the agent reads them instead of writing its own CombatController from scratch.

A separate section lists anti-patterns. Linear damage scaling, defense stats stacking to 100%, skipping hit recovery, hitbox math in `_process()` instead of `_physics_process()`, float equality checks, stats stored as Nodes rather than Resources, a missing `duplicate()` on shared resources. These are the usual places where balance and frame time fall apart, and the skill blocks them outright.

The skill sits in a chain: `godot-project-foundations` → `godot-characterbody-2d` → `godot-combat-system` → `godot-rpg-stats` → `godot-inventory-system` → `godot-ability-system`, continuing to `godot-monte-carlo-balancer`. If your project is not built on those foundations yet, you start at the front of the chain. Everything here assumes Godot and GDScript, so other engines get nothing from it.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-action-rpg -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-action-rpg -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-action-rpg -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-genre-action-rpg
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-genre-action-rpg/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-action-rpg -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-genre-action-rpg
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-action-rpg -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/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-genre-action-rpg/SKILL.md

## When to use it
- build hitbox combat with stat-based damage
- generate loot with rarity tiers and affixes
- set up a skill tree and an XP curve
- move character stats into Resources instead of Nodes
- parse large inventories off the main thread

## Example prompts
- add the godot-genre-action-rpg skill and build hitbox combat
- generate loot with rarity tiers and affixes by level
- move character stats into Resources and recalculate on gear change

## Similar
- [godot-gdscript](https://affpapa.org/en/nevibecode/skills/godot-gdscript.md) — skill · 6500 installs
- [godot-physics](https://affpapa.org/en/nevibecode/skills/godot-physics.md) — skill · 6300 installs
- [godot-mcp-enhanced](https://affpapa.org/en/nevibecode/mcp/godot-mcp-enhanced.md) — MCP server · ★ 103
- [godot](https://affpapa.org/en/nevibecode/rules/godot.md) — rule · ★ 3579
- [spritecook-use-assets-in-godot](https://affpapa.org/en/nevibecode/skills/spritecook-use-assets-in-godot.md) — skill · 555 installs
- [godot-ui](https://affpapa.org/en/nevibecode/skills/godot-ui.md) — skill · 2700 installs

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 51 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