gdtoolkit

Lint and format GDScript files with gdlint and gdformat.

511|44|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill gdtoolkit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gdtoolkit
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/core/gdtoolkit
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill gdtoolkit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the need to manually review and correct GDScript style and lint violations by providing deterministic linting and formatting guidance for Godot projects.

Core Features & Use Cases

  • GDScript linting (gdlint): Detects rule violations like naming/style issues and reports them with file/line/rule details.
  • Deterministic formatting (gdformat): Rewrites code to a consistent style in-place or via diff/check modes to prevent formatting churn.
  • Offline, Godot-free execution: Runs as a standalone Python tool and does not require launching the Godot editor.

Use case: you modify a large batch of .gd files and want the agent output to match your repository’s conventions, avoid recurring CI lint failures, and keep formatting stable for clean diffs.

Quick Start

Install the matching gdtoolkit version for your Godot major version, then run lint and apply gdformat to your modified .gd files to eliminate style errors and enforce consistent formatting.

Frequently Asked Questions about gdtoolkit

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

FAQPage Schema
How do I lint and format GDScript files without launching the Godot editor?

You can lint and format GDScript files offline using a standalone Python CLI tool. It enforces consistent code style and reports rule violations without requiring the Godot editor to be running.

How do I fix recurring GDScript lint failures in my CI pipeline?

To fix recurring GDScript lint failures in your CI pipeline, run a deterministic formatter and linter on your modified files. This enforces repository conventions and prevents formatting churn for clean diffs.

Do I need a specific Python package version to lint GDScript for my Godot project?

Yes, you need to install a matching Python package version for your Godot major version. This ensures the GDScript parser correctly understands your project's syntax and rules.

Can I check GDScript formatting changes via diff mode instead of rewriting files in-place?

Yes, you can check GDScript formatting changes via diff or check modes. These modes allow you to preview style corrections without rewriting the files directly in-place.

What is the best way to enforce consistent code style across a large batch of GDScript files?

The best way to enforce consistent code style across a large batch of GDScript files is by applying a deterministic formatter. It rewrites code to a uniform style and eliminates manual style corrections.

Why does my GDScript linter report naming and style rule violations after code generation?

GDScript linters report naming and style violations after code generation to surface rule mismatches. Running a linter checks file and line details to help you diagnose and correct these issues.