gdscript-lint

Format and lint GDScript files using gdformat and gdlint.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/CuriousCrow123/godot-compound --skill gdscript-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gdscript-lint
Source: https://github.com/CuriousCrow123/godot-compound/tree/main/skills/gdscript-lint
Command: npx skills add https://github.com/CuriousCrow123/godot-compound --skill gdscript-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GDScript projects often suffer from inconsistent formatting and lint issues that reduce readability and increase review time. This skill runs standard formatting and lint checks using gdtoolkit to help maintain clean, reliable code before commits.

Core Features & Use Cases

  • Run gdformat --check . to enforce consistent formatting across all GDScript files.
  • Run gdlint . to enforce lint rules such as member ordering, naming conventions, and resource usage.
  • Auto-fix formatting with gdformat where possible to reduce manual edits.

Quick Start

Run gdformat --check . and gdlint . to validate formatting and lint rules for your GDScript code.

Frequently Asked Questions about gdscript-lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I format and lint GDScript files before a commit?

To format and lint GDScript before a commit, run `gdformat --check .` to enforce consistent formatting and `gdlint .` to check naming conventions and member ordering. This ensures clean, readable Godot project code.

What is the best way to enforce consistent GDScript formatting in a Godot project?

The best way to enforce consistent GDScript formatting is running `gdformat --check .` across your project files. You can also auto-fix formatting with `gdformat` to reduce manual edits and maintain a uniform style.

Do I need Python and gdtoolkit to run gdlint and gdformat?

Yes, you need Python and the gdtoolkit package to run gdlint and gdformat. These prerequisites enable the standard formatting and lint checks required to maintain error-free GDScript code.

What lint rules does gdlint enforce for GDScript?

gdlint enforces GDScript lint rules such as member ordering, naming conventions, and resource usage. Running `gdlint .` helps identify style issues to improve code readability and reduce review time.

Can I automatically fix GDScript formatting issues instead of manually editing code?

Yes, you can auto-fix GDScript formatting issues by running `gdformat`. This reduces manual edits by automatically applying consistent style corrections across your Godot project files.