GDScript Validate

Refresh Godot's language server cache and check GDScript diagnostics.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/aiguy611/cc-tools --skill gdscript-validate-aiguy611
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GDScript Validate
Source: https://github.com/aiguy611/cc-tools/tree/main/.github/skills/gdscript-validate
Command: npx skills add https://github.com/aiguy611/cc-tools --skill gdscript-validate-aiguy611

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Validate GDScript changes by refreshing Godot's language server cache and checking diagnostics.

Core Features & Use Cases

  • Refresh Godot's language server cache after creating or editing GDScript files to ensure new classes and changes are recognized.
  • Validate diagnostics either for a specific file or the entire project, surfacing errors and warnings to guide fixes.

Quick Start

Run the refresh_godot_lsp.sh script to update the Godot language server cache and then review diagnostics.

Frequently Asked Questions about GDScript Validate

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

FAQPage Schema
How do I refresh the Godot LSP cache to recognize new GDScript classes?

To refresh the Godot LSP cache, run the refresh_godot_lsp.sh script after creating or editing GDScript files. This updates the language server cache so new classes and changes are properly recognized for diagnostics.

Why does my Godot language server not see recent GDScript edits?

Your Godot language server may not see recent GDScript edits because the LSP cache is stale. Refreshing the cache via the refresh_godot_lsp.sh script forces the server to recognize new file changes before checking diagnostics.

How do I validate GDScript diagnostics for an entire Godot project?

To validate GDScript diagnostics for an entire Godot project, refresh the language server cache first, then run a full-project diagnostics check. This surfaces all errors and warnings across your project files to guide necessary fixes.

Do I need a Godot environment to validate GDScript changes?

Yes, you need a Godot environment to validate GDScript changes. The validation process requires a dedicated shell script to query the language server and optionally leverages the MCP IDE server for diagnostics.

Can I validate diagnostics for a single GDScript file instead of the whole project?

Yes, you can validate diagnostics for a single GDScript file. The validation process supports both single-file edits and batch edits within a Godot project, surfacing errors and warnings to guide fixes.

What is the best way to check for GDScript errors after editing files?

The best way to check for GDScript errors is to perform a one-time language server cache refresh after edits, followed by a diagnostics query. This ensures all recent changes are recognized and errors are accurately reported.