godot-ability-system — Claude Code skill for Godot abilities
A skill that gives your coding agent patterns for Godot ability systems: cooldowns, combos, skill trees, charges and status effects.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ability-system -a claude-codeWhat godot-ability-system does
The skill lays out how to structure ability systems for RPGs and action games in Godot. Live cooldowns, the global cooldown and execute() calls belong in a scene-scoped manager under the caster, not in a global Autoload, because a global cast oracle breaks encapsulation and multiplayer authority. An Autoload is fine for unlock ranks and flags only.
It ships GDScript files: ability_resource.gd holds data plus a virtual execute(), ability_manager.gd and ability_container.gd cover the two scene-scoped manager styles, combo_tracker.gd handles windowed chains, charge_ability.gd covers multi-charge recharges, and skill_node.gd with skill_tree_manager.gd builds prerequisite graphs. Status effects run through status_effect.gd and status_effect_manager.gd, while ability_caster_network.gd predicts locally and lets authority validate.
Cooldown ticking and status durations must run on _physics_process(delta) or Timer nodes, otherwise frame spikes throw the timings off. Status templates applied at runtime need duplicate(true) — a single shared .tres mutates for every character using it. Saving cooldowns means storing absolute end timestamps rather than leftover seconds. The deeper combo, charge and networking material sits in a separate reference file that you skip on a first AbilityResource plus manager pass.
What it helps with
- build ability cooldowns that resist button spam
- chain combo sequences into a finisher
- lay out a skill tree with prerequisites
- add multi-charge abilities with recharge ticks
- persist cooldowns across sessions without exploits
Example prompts for the agent
- Create an AbilityResource for a fireball and wire it to the scene-scoped AbilityManager
- Add a global cooldown between casts and gate casting during animation lock
- Build a skill tree with prerequisites that grants abilities to the caster
How to install godot-ability-system
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ability-system -a claude-code2Manually: put the files in place
~/.claude/skills/godot-ability-system/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-ability-system/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ability-system -a codex2Manually: put the files in place
.agents/skills/godot-ability-system/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ability-system -a cursor2Manually: put the files in place
.cursor/skills/godot-ability-system/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-ability-system2Manually: put the files in place
.github/skills/godot-ability-system/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ability-system -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-ability-systemManually: put the files in place
.devin/skills/godot-ability-system/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ability-system -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-ability-system
How do I install godot-ability-system in Claude?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ability-system -a claude-code. The skill lands at ~/.claude/skills/godot-ability-system/SKILL.md.
What does godot-ability-system do?
It hands your agent ready patterns for Godot ability systems: cooldowns, combos, charges, skill trees and status effects. The agent leans on them whenever you ask for character progression work.
Where should the ability manager live?
In the scene, under the caster itself. An Autoload works for unlock ranks and flags only, since global cast state breaks encapsulation and multiplayer authority.