Back to Skills

performance-optimization

Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing.

42,350stars4,649forksUpdated 5/16/2026

Security Assessment

Safe(100/100)
Security Score100/100

About performance-optimization

The performance-optimization skill focuses on improving application efficiency by systematically identifying and addressing performance bottlenecks. It guides users to measure and analyze performance metrics before attempting any optimizations, ensuring that efforts are data-driven rather than speculative. By focusing on key indicators such as Core Web Vitals, load times, and response metrics, this skill helps prevent unnecessary complexity while improving user experience and meeting defined performance requirements.

Core features of this skill include a structured optimization workflow with distinct steps: measure, identify, fix, verify, and guard. It provides guidance for both frontend and backend environments, emphasizing the importance of synthetic testing tools like Lighthouse and real user monitoring with libraries such as web-vitals. Users can profile first page loads, interactions, page navigations, and backend API endpoints to pinpoint specific causes of slowness, from render-blocking resources to database query inefficiencies. The skill also highlights best practices for monitoring and regression prevention after optimizations.

This skill is ideal for developers, QA engineers, and performance specialists who are responsible for maintaining application speed and reliability. Typical use cases include situations where performance requirements are defined, regressions are suspected after code changes, Core Web Vitals scores are below target, or features need to handle large datasets or high traffic. It is also applicable in continuous integration environments where performance regressions must be automatically detected and addressed, helping teams maintain fast, responsive, and scalable applications.

FAQ

When should I use the performance-optimization skill?

Use it when there are defined performance requirements, when users or monitoring report slow behavior, when Core Web Vitals are below thresholds, or when profiling reveals bottlenecks needing fixes. Avoid using it before identifying actual performance issues.

Does this skill support both frontend and backend optimization?

Yes, it provides guidance for measuring and profiling performance in both frontend environments (using tools like Lighthouse and web-vitals) and backend systems (via logging, APM, and database timing).

What metrics does this skill focus on for web performance?

It emphasizes Core Web Vitals: Largest Contentful Paint (LCP), Interaction to Next Paint (INP), and Cumulative Layout Shift (CLS), providing target ranges for good, needs improvement, and poor performance.

Can this skill help prevent regressions after optimizations?

Yes, the workflow includes a 'GUARD' step to add monitoring and tests, ensuring that performance improvements are maintained and regressions are detected early.

Is it necessary to measure before optimizing?

Absolutely. The skill stresses that measuring before making changes is crucial to avoid premature optimization, which can increase complexity without delivering real performance gains.

Install performance-optimization

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill