Design Motion Audit

Audit the target surface (a repo, route, screen, component, or 3D scene) for motion quality and implementation safety, and return a prioritized punch list with exact files, severity, reasoning, and concrete fixes. This skill diagnoses; it routes implementation to the owning skill (expo-motion, web-three-r3f for R3F setup and correctness, r3f-scene-polish for look-dev, or gsap). Token and motion-system work is handled here via references/design-system-tokens.md and scripts/scaffold_motion_tokens.py.

How to run

1. Optionally run the static analyzers to gather leads (treat findings as leads, verify each against the real code before reporting):

   python3 scripts/detect_motion_stack.py <project-root> --pretty   # what stacks/files exist
   python3 scripts/audit_motion_system.py <project-root> --pretty    # heuristic motion-quality scan