file-refactor-safety

Validate GDScript and metadata references during move, rename, and delete operations.

2|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/DubDev720/gdref --skill file-refactor-safety
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-refactor-safety
Source: https://github.com/DubDev720/gdref/tree/main/godot-skills/godot-operational/file-refactor-safety
Command: npx skills add https://github.com/DubDev720/gdref --skill file-refactor-safety

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the risks associated with moving, renaming, or deleting GDScript and related metadata files, ensuring that project references remain intact and consistent.

Core Features & Use Cases

  • Reference Integrity: Guarantees that script and resource references are preserved after file operations.
  • Metadata Synchronization: Keeps scene and resource references in sync with file changes.
  • Diagnostic Validation: Provides clear confirmation of project health post-refactoring.
  • Use Case: When renaming a core script file, this Skill ensures all other scripts and scenes that reference it are updated correctly, preventing runtime errors.

Quick Start

Use the file-refactor-safety skill to plan and execute a safe rename operation for the script 'old_script.gd' to 'new_script.gd'.

Frequently Asked Questions about file-refactor-safety

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

FAQPage Schema
How do I rename a GDScript file without breaking scene references?

Renaming a GDScript file safely requires synchronizing all associated metadata and resource references to prevent broken links and runtime errors. Validating that script dependencies remain intact during the operation ensures project health and reference integrity.

What is metadata synchronization for GDScript file operations?

Metadata synchronization for GDScript file operations is the process of keeping scene and resource references consistent when files are moved, renamed, or deleted. It guarantees reference integrity by ensuring all dependencies are updated to match the new file structure.

How do I safely delete a GDScript file and its metadata?

To safely delete a GDScript file and its metadata, you must validate that script and resource references are removed or updated to prevent broken links. This requires following specific rules for batch operations and running post-refactor diagnostics to confirm project health.

Can I batch rename multiple GDScript files at once?

Yes, you can batch rename multiple GDScript files, but it requires adherence to specific rules for batch operations and paired file updates. This ensures metadata synchronization and reference integrity are maintained across all affected scripts and scenes during the refactoring process.

Why do I get runtime errors after moving a script file in my project?

Runtime errors after moving a script file occur because scene and resource references are no longer synchronized with the new file paths. Post-refactor diagnostics are needed to validate project health and confirm that all script and metadata references remain intact.

Does file refactoring require post-move diagnostics for GDScript projects?

Yes, file refactoring requires post-move diagnostics for GDScript projects to confirm project health and validate reference integrity. These diagnostics provide clear confirmation that script and resource references remain synchronized after batch operations and paired file updates.