performance-auditor

Diagnose performance bottlenecks in emotive-mascot animations across devices.

18|1|Updated Sep 3, 2025
One-click install
npx skills add https://github.com/joshtol/emotive-engine --skill performance-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-auditor
Source: https://github.com/joshtol/emotive-engine/tree/main/skills/performance-auditor
Command: npx skills add https://github.com/joshtol/emotive-engine --skill performance-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and resolve performance bottlenecks in animations, ensuring smooth 60 FPS experiences on desktop and adaptive performance on mobile, preventing lag and memory leaks.

Core Features & Use Cases

  • FPS & Memory Monitoring: Utilize built-in debug tools and browser DevTools to diagnose frame rate drops, stuttering, and memory growth over time.
  • Adaptive Quality: Implement dynamic adjustments to particle counts, trail lengths, and effects based on device capabilities and real-time performance.
  • Particle System Optimization: Employ advanced techniques like particle pooling and spatial partitioning for efficient physics calculations and rendering.
  • Use Case: Your mascot animations are lagging on older mobile phones. Use this skill to profile the performance, reduce particle counts for mobile, and implement adaptive quality settings to maintain a smooth 30 FPS.

Quick Start

Use the performance-auditor skill to enable the built-in performance monitor for the emotive-mascot, displaying current FPS and memory usage.

Frequently Asked Questions about performance-auditor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify why my animations are dropping frames on mobile?

Frame-rate drops stem from excessive particle counts, memory leaks, or bundle bloat. Use built-in performance monitoring and browser DevTools to measure FPS, memory growth, and rendering time. Diagnose bottlenecks by profiling particle systems, trail effects, and asset sizes against your device's 30–60 FPS adaptive target.

Can I optimize particle systems for low-end devices without rebuilding the animation?

Yes. Implement adaptive quality that dynamically adjusts particle counts, trail lengths, and effect intensity based on detected device capabilities and real-time FPS. Deploy particle pooling and spatial partitioning to reduce physics calculations. Low-end devices run 200–400 particles at 30 FPS minimum while desktop maintains 800–1000 at 60 FPS.

What's the best way to keep bundle size under control while preserving animation quality?

Profiling and budgeting are critical. Target full bundles under 250 KB gzipped, minimal under 120 KB, and audio under 200 KB. Profile asset compression, remove unused effects, and measure trade-offs between visual fidelity and file size. Use performance monitoring to confirm 30–60 FPS delivery across desktop, mobile, and low-end platforms.

How do I prevent memory leaks in long-running animations?

Monitor runtime memory usage over time with DevTools and built-in debug tools. Ensure memory stays under 100 MB at runtime and initial load under 50 MB. Use particle pooling to reuse objects, properly release event listeners, and validate that memory does not grow unbounded during extended playback.

Does animation optimization work the same way on desktop, mobile, and low-end devices?

No. Desktop targets 60 FPS with 800–1000 particles; mobile adapts between 30–60 FPS with 400–600 particles; low-end devices maintain 30 FPS minimum with 200–400 particles. Use adaptive quality settings and real-time performance monitoring to detect device capabilities and adjust effects, bundle size, and particle counts accordingly.