Skip to content
SkillModel-led1,897 tokens in use

godot-gdscript

Writes typed GDScript 2.0 for Godot 4.7 with @export, @onready and await, ports 3.x code, and compile-checks every script headless.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/godot/godot-gdscript
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing godot-gdscript costs

113tokens idle
1,897tokens in use
2,974tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure25/25
  • Examples15/15
  • Output15/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    assets/check_scripts_compile.gd

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill helps an agent write GDScript that parses on the project’s Godot version and behaves the way the engine schedules it. It checks the version and warning settings in project.godot, types members and returns by default, and puts code in the right callback among _init, _ready, _physics_process and _process.

It includes patterns for a typed node script, typing values that come back as Variant, and a coroutine that survives its node being freed. A bundled GDScript check loads every script with autoloads and class_name types registered and lists each broken file with the engine’s parse error. The gotchas cover Cannot infer the type, silent awaits and 4.7 behaviour changes.

What You Get

  • A workflow that matches the project’s version and warning settings, types by default and verifies compile and runtime behaviour
  • Patterns for a typed node script, typing Variant results and a coroutine that survives node removal
  • A compile-check script that loads every .gd file and reports the engine’s parse error and line per broken file
  • A gotcha list for type inference errors, silent awaits, missing class_name cache, 4.7 return-type and packed-array changes and 3.x syntax

Common Use Cases

  • Fixing Cannot infer the type of variable errors in a GDScript project
  • Debugging a coroutine whose code after await never runs
  • Finding why an @onready variable is null
  • Porting Godot 3 scripts to the 4.x annotations and await syntax

What Makes It Unique

The skill explains why Godot’s own —check-only misleads: it parses one file without autoloads, so scripts that name an autoload fail. It ships a compile check that loads every script with autoloads and class names registered, and it records 4.7 changes such as inherited override return types and packed-array element writes that skip setters.

Under The Hood

The agent loads the SKILL.md and, when needed, a reference on every export and other annotation, typed collections and lifecycle order. It runs commands in your project: a headless asset import on a fresh checkout, the Godot binary headless with the bundled compile-check script, and a short headless run of the main scene with the log redirected to a file and searched with grep, plus the optional Python project checker from the godot-nodes-scenes skill. It reads project files and writes the log file; it makes no network calls. The shipped GDScript check is a file type the scanner cannot read, so what it does was not analysed and is worth a look before you run it.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers