godot-auditor — Claude Code skill: Godot 4.7 architecture audit
godot-auditor scans Godot 4.7 projects for architectural decay: signal decay, memory leaks, untyped containers, export violations. Use it to catch hidden problems before build.
LGPL-3.0 307 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-auditor -a claude-codeWhat godot-auditor does
godot-auditor runs structured checks against a Godot project using four deterministic scanners. The audit_signals.py scanner detects string-based signal connections instead of typed references; audit_memory_fragmentation.gd tracks ObjectDB leaks and orphaned nodes; audit_type_hints.py flags untyped Array and Dictionary in hot loops; purge_report_generator.gd aggregates findings into a remediation report.
The skill follows a protocol: identify the architectural sector, load rules for that sector, then run the corresponding scanners from disk. It catches critical mistakes: dynamic signals using .connect("string", ...) instead of signal.connect(), material duplication instead of instance_uniform, Expression.execute() with user input (RCE vector), export variables with wrong case sensitivity. Requires local project file access and Python in the environment.
What it helps with
- detect signals connected by string instead of typed references
- identify orphaned nodes and ObjectDB memory leaks
- flag untyped Array and Dictionary in performance-critical code
- find duplicate materials breaking draw-call batching
- check for RCE vectors in Expression.execute and OS.execute calls
Example prompts for the agent
- Audit my project for signal decay and memory leaks
- Run a full architecture check on this Godot 4.7 codebase, find type violations
- Scan for orphaned nodes and duplicate materials
How to install godot-auditor
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-auditor -a claude-code2Manually: put the files in place
~/.claude/skills/godot-auditor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-auditor/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-auditor -a codex2Manually: put the files in place
.agents/skills/godot-auditor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-auditor -a cursor2Manually: put the files in place
.cursor/skills/godot-auditor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-auditor2Manually: put the files in place
.github/skills/godot-auditor/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-auditor -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-auditorManually: put the files in place
.devin/skills/godot-auditor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-auditor -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-auditor
How do I install godot-auditor in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-auditor -a claude-code, then open ~/.claude/skills/godot-auditor/SKILL.md.
What does godot-auditor check?
It analyzes Godot 4.7 code for architectural problems: string-based signals, untyped containers, memory leaks, material duplication, and expression execution vulnerabilities.
What does it need to work?
Python must be available, and the skill needs local access to project files. It runs Python scanners and reads scene state through GDScript utilities.