audit-spritekit

Scan SpriteKit game code for the most common bugs that cause physics misbehavior, frame drops, and memory growth.

What This Command Does

Launches the spritekit-auditor agent to find scene-graph and physics issues that don't show up in tests but cripple gameplay performance.

What It Checks

1. Physics bitmask issues – categoryBitMask and contactTestBitMask set in conflicting ways, causing missed collisions or false positives
2. Draw-call waste – texture atlas misuse, unbatched sprite renders, redundant SKShapeNode allocations per frame
3. Node accumulation – nodes added to the scene that are never removed, causing the tree to grow indefinitely
4. Action leaks – SKAction sequences with retain cycles via closures, or repeating actions never cancelled
5. Coordinate confusion – mixing scene/view/screen coordinate spaces, especially around convertPoint(toView:)

Related Agent

• spritekit-auditor – The agent that powers this command
• spritekit-ref – SpriteKit API reference