bjornmelin/design-motion-audit
plugins/design-motion/skills/design-motion-audit/SKILL.md
Audit a repository, route, screen, component, or 3D scene for motion quality — design-token consistency, R3F/three.js polish, Reanimated native motion, interaction physicality, frame-rate/draw-call risk, reduced-motion coverage, accessibility, and missing hallmark-motion opportunities. Use when asked to audit, review, critique, find gaps, check performance, verify reduced motion, or assess whether UI animation feels premium. Returns a prioritized punch list. For building/implementing motion route to design-motion-system, expo-motion, web-three-r3f, r3f-scene-polish, or gsap.
$ install --global
skillsauthnpx skillsauth add bjornmelin/dev-skills design-motion-auditInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 9, 2026, 3:33 AM86.3s12 files scanned
SKILL.md
- name:
- design-motion-audit
- description:
- Audit a repository, route, screen, component, or 3D scene for motion quality — design-token consistency, R3F/three.js polish, Reanimated native motion, interaction physicality, frame-rate/draw-call risk, reduced-motion coverage, accessibility, and missing hallmark-motion opportunities. Use when asked to audit, review, critique, find gaps, check performance, verify reduced motion, or assess whether UI animation feels premium. Returns a prioritized punch list. For building/implementing motion route to design-motion-system, expo-motion, web-three-r3f, r3f-scene-polish, or gsap.
- license:
- MIT
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 (design-motion-system for
system/token work, expo-motion, web-three-r3f, r3f-scene-polish, or gsap).
How to run
-
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 -
Read the flagged files and judge against the dimensions below.
-
Return the punch list, most-severe first.
Audit dimensions
- Design tokens & consistency — hardcoded durations/easings/springs vs
tokenized values; naming by intent. (
references/motion-vocabulary.md) - R3F / three.js / WebGL —
setStateinuseFrame, missing delta-time, per-frame allocations, disposal, DPR, shadows, postprocessing budget. - Reanimated / Expo / gestures — JS-thread per-frame work, deprecated
runOnJS/runOnUI, worklet misuse, interruptibility, layout-vs-transform. - Interaction physicality — velocity-aware release, cancellation-safety.
- Performance risk — frame budget, draw calls, texture/asset weight, blur.
(
references/performance-accessibility.md) - Reduced-motion coverage — every camera move, parallax, loop, and bounce has a reduced-motion branch that preserves functional feedback.
- Accessibility & readability — text legibility during motion.
- Missing hallmark opportunities — where a signature motion would add value.
Score against references/quality-gates.md, and shape the output with
references/report-template.md. For any change with a visible motion surface, add
runtime proof (references/runtime-verification.md) — static findings alone do
not prove a scene renders or holds its frame budget; the motion-runtime-verifier
subagent (design-motion plugin) drives that when the browser tools are available.
For deep implementation fixes, hand each finding to the skill that owns its stack.
Related Skills
bjornmelin/multi-model-review
development
VerifiedTrustedCommunity
Pre-PR multi-model review, parallel opus and codex exec adversarial lanes, then adversarial verification of merged findings. Read-only. Use before shipping nontrivial diffs.
3SKILL.mdUpdated Jul 23, 2026
bjornmelin/codex-review
tools
VerifiedTrustedCommunity
Independent gpt-5.6 diff review via the Codex CLI, normal or steerable adversarial with JSON findings. Use before shipping nontrivial changes.
3SKILL.mdUpdated Jul 23, 2026
bjornmelin/codex-delegate
development
VerifiedTrustedCommunity
Delegate implementation, investigation, or bulk work to gpt-5.6 codex via pinned codex exec. Use for clear-spec builds, migrations, debugging, or any task MODELS.md routes to codex.
3SKILL.mdUpdated Jul 23, 2026
bjornmelin/pre-mortem
development
VerifiedTrustedCommunity
Adversarial pre-mortem: imagine the plan failed, work backwards to surface risky assumptions + irreversible bets, then harden them. Proactively offer it (after the current request; confirm first) before a hard-to-reverse or one-way-door call (API, schema, framework, a hire), an all-upside plan, or unvalidated assumptions. Also on request.
3SKILL.mdUpdated Jul 22, 2026