GDScript Format

Format and lint GDScript files to enforce consistent code style.

11|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/minami110/claude-godot-tools --skill gdscript-format
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GDScript Format
Source: https://github.com/minami110/claude-godot-tools/tree/main/gdscript-toolkit/skills/gdscript-format
Command: npx skills add https://github.com/minami110/claude-godot-tools --skill gdscript-format

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, unzip, and includes scripts (resource) components.

What problem does it solve?

This Skill automates formatting and linting of GDScript files to ensure consistent code style across a Godot project, reducing code review time and semantic changes from formatting.

Core Features & Use Cases

  • Automated formatting: Apply consistent style to one or more .gd files using the included format script.
  • Linting checks: Detects common style and quality issues to improve maintainability.
  • CI-friendly: Provides check mode to fail when changes are needed, enabling automated pipelines.

Quick Start

Install the formatter binary using the install script included in this skill (scripts/install.sh) and run the formatter on your GDScript files with scripts/format.sh.

Frequently Asked Questions about GDScript Format

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

FAQPage Schema
How do I format GDScript files to enforce consistent code style?

GDScript formatting applies consistent style rules to .gd files automatically. Install the gdscript-formatter binary using scripts/install.sh, then run scripts/format.sh on your files to fix indentation, spacing, and other style inconsistencies across your Godot project.

Can I use GDScript formatting in a CI pipeline to fail on style violations?

Yes, GDScript formatting supports check mode for CI integration. Run scripts/lint.sh to detect style issues and return standard exit codes that fail your pipeline when formatting changes are needed, preventing non-compliant code from merging.

What does GDScript linting check for?

GDScript linting detects common style and quality issues in .gd files, including code organization problems. It identifies maintainability concerns and supports configurable lint rules to enforce your project's code standards.

Does GDScript formatting work on both Linux and Windows?

Yes, GDScript formatting runs across Linux and Windows environments. The included install script sets up the gdscript-formatter binary for your platform, enabling consistent formatting workflows regardless of your development OS.

Can I use GDScript formatting with code reordering?

Yes, GDScript formatting supports reorder-code mode to reorganize code structure alongside style fixes. This option rearranges code elements while maintaining functionality, useful for enforcing consistent code organization patterns.

What are the prerequisites for using GDScript formatting?

GDScript formatting requires curl and unzip to download and install the gdscript-formatter binary. Run scripts/install.sh first to set up the formatter, then use scripts/format.sh and scripts/lint.sh on your Godot project's .gd files.