# godot-rpg-stats

A skill that steers your coding agent through building an RPG stat system in Godot: attributes, modifiers, leveling and damage formulas.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 446 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-rpg-stats/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/godot-rpg-stats

## What it does

The skill lays out character stats as Godot Resources. Base attributes like strength and dexterity live in a designer-authored template, and a runtime component duplicates that template and applies modifiers on top. Derived stats recalculate from signals when a base value changes, not every frame.

It ships a GDScript file per layer: base stat template, XP curve, modifier stacking, buff and debuff data, a damage formula handler, label syncing for the UI, and saving progression to `.tres`. Buffs are authored as `StatusEffectData` resources typed `ADDITIVE`, `MULTIPLICATIVE` or `OVERRIDE`. Two rules stand out: keep percentages in `float`, because integers truncate them, and give every modifier a unique ID, otherwise you cannot remove one specific effect later.

Damage math sits in a shared RefCounted helper used by both player and NPC. Worth checking your own project if damage formulas are currently spread across the character script. The skill targets Godot and GDScript, and your agent needs file access to read the skill's scripts.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-rpg-stats/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-rpg-stats
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- define base character attributes as a Resource
- stack additive and multiplicative modifiers in one place
- recalculate derived stats when equipment changes
- move damage formulas into a shared module for player and NPC
- save character progression to `.tres` without temporary buffs

## Example prompts
- Build a character stat system on Resources using the godot-rpg-stats skill
- Add a speed buff with StatusEffectData typed MULTIPLICATIVE and recalculate derived stats
- Move damage calculation into damage_formula_handler.gd and wire it to both player and NPC

## Similar
- [godot-nodes-scenes](https://affpapa.org/en/nevibecode/skills/godot-nodes-scenes.md) — skill · 6400 installs
- [godot-csharp](https://affpapa.org/en/nevibecode/skills/godot-csharp.md) — skill · 5900 installs
- [cli-anything-godot](https://affpapa.org/en/nevibecode/skills/cli-anything-godot.md) — skill · 548 installs
- [godot-prompter](https://affpapa.org/en/nevibecode/plugins/godot-prompter.md) — plugin · ★ 867
- [godot](https://affpapa.org/en/nevibecode/rules/godot.md) — rule · ★ 3579
- [godot-mcp-enhanced](https://affpapa.org/en/nevibecode/mcp/godot-mcp-enhanced.md) — MCP server · ★ 103

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