agentleFS
WST2002WST2002/claude-code-skills/skills/web-performance-audit/SKILL.md

web-performance-audit

Skill4 starsChanged 27 days agoMITView on GitHub

Use when a website or web app is slow, Lighthouse or PageSpeed scores are low, Core Web Vitals (LCP, INP, CLS) fail, the bundle is too large, pages load or scroll with jank, or React/Next.js/Vue renders feel sluggish.

7 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 7 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Start with the metric summary (measured or estimated).

    line 31

“Common” is measured: kept by at least 6 in 10 of the 7 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Web Performance Audit

Overview

Tie every fix to the metric it moves. Find the few causes that dominate load time and interaction delay, show where they are in the code, and estimate the gain.

Method

  1. Measure if possible. With a URL: run npx lighthouse <url> --only-categories=performance --output=json --quiet or use PageSpeed Insights. Record LCP, INP (or TBT), CLS and total JS. Without a URL, audit the code and say that numbers are estimates.
  2. Find the LCP element (usually the hero image or heading) and trace what delays it: server time, render-blocking CSS/fonts/scripts, image size and priority.
  3. Sweep the code with checklist.md: images, fonts, JavaScript weight, third parties, rendering, data fetching, caching.
  4. Rank by impact on the failing metric, then by effort.
  5. Report using the contract below.

Targets (75th percentile, mobile)

MetricGoodUsual causes when poor
LCP≤ 2.5 sLarge or lazy-loaded hero image, render-blocking CSS/fonts, slow TTFB, client-side data fetch before render
INP≤ 200 msLong tasks, heavy hydration, expensive re-renders, synchronous work in event handlers
CLS≤ 0.1Images or embeds without size, late-loading fonts, injected banners above content
JS (compressed)< 170 KB on first loadWhole-library imports, no code splitting, duplicated packages

Output contract

Start with the metric summary (measured or estimated). Then, highest impact first:

### [High | Medium | Low] Title
- Metric: LCP | INP | CLS | TTFB | bundle size
- Where: file:line or resource URL
- Evidence: the code or measurement that shows the problem
- Fix: the exact change (code snippet or config)
- Expected gain: e.g. "LCP −0.8 s", "−120 KB JS"

End with Quick wins (under an hour each) and Already good (what you checked that is fine).

Common mistakes

  • Lazy-loading the LCP image. It must load eagerly with high priority.
  • Recommending generic tips ("minify CSS") that the build already does.
  • Memoizing everything instead of fixing the one component that re-renders a large list.
  • Ignoring third-party scripts, which often cost more than the app itself.
  • Claiming exact gains without measurement; label estimates.

Made by Wageesha Tripathi · LinkedIn · Email · More skills

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.