particles-review

What problem does it solve?

This Skill prevents broken or misleading particle effects by reviewing Godot Particles implementations against common engine gotchas that often cause silent failures.

Core Features & Use Cases

• Post-implementation particle code review: Scans for known pitfalls related to GPU/CPU particles, particle materials, trails, sub-emitters, collision nodes, and runtime emission/property changes.
• Gotcha-to-fix reporting: For each detected issue, it cites a gotcha ID, shows the offending code, and provides a concrete correction.
• Optional automated verification: Uses a checklist to map each gotcha to static and runtime checks, including an optional headless compilation run.

Use case: After agents generate or modify a scene that uses GPUParticles3D with trails and sub-emitters, run this reviewer to ensure collision and trail behavior won’t silently fail in Godot 4.x.

Quick Start

Run particles-review after particle-related code is implemented or modified, especially if the project touches GPUParticles2D/3D, CPUParticles2D/3D, particle collision nodes, trail configuration, or runtime .amount/.emitting changes.